1. 程式人生 > >[Github使用簡明教程]如何提交程式碼到Github

[Github使用簡明教程]如何提交程式碼到Github

囉嗦幾句

可能很多人聽過Github,也上過Github,甚至從Github獲取過許多開源的程式碼,但是如果要將專案程式碼上傳到Github上時卻束手無策。 今天筆者就手動做了一個簡明教程分享出來。

Github簡介

官方介紹是這樣的:

GitHub is a development platform inspired by the way you work. From open source to business, you can host and review code, manage projects, and build software alongside millions of other developers.

GitHub是一個提供給您工作靈感的開發平臺。無論是開源還是商業性質,您都可以在此託管和審查程式碼,管理專案,並與全球數百萬其他開發人員一起構建軟體。

大白話版:Github是一個基於git版本控制的專案託管平臺,這裡託管著全世界最優秀的開源和商業專案。

作為程式設計師的你,如果還不知道Github,或者不知道如何託管你的專案程式碼到Github,不如跟著筆者一起來託管一個專案試試。

提交程式碼到Github的兩種方式

Github在Windows,MacOS平臺的GUI客戶端,同時這兩個平臺也支援命令列方式提交,其他平臺,如Linux只能使用命令列。

但是無論是客戶還是命令列都需要有一個Github賬號。所以下面首先需要註冊一個Github賬號。

註冊Github賬號

如果你已經有一個Github賬號了,可以直接跳過這一步。

  1. 點選介面右上角的“註冊”-Sign Up
  2. 填寫你的使用者名稱id(字母,數字,短橫線,不支援下劃線)
  3. 填寫你的註冊郵箱地址,這個郵箱地址後期可在個人中心更改,太貼心了
  4. 填寫你的註冊密碼
  5. 點選最下方的Create an account按鈕可以建立一個賬號。

利用Github客戶端提交程式碼

Github客戶端下載地址:Github客戶端。支援MacOS 10.9+ && Win7+。這個我用的不多,就不講了,GUI操作應該也不會太難。

利用命令列提交程式碼到Github

由於Github版本控制使用的是Git,所以需要先下載並配置好Git環境。

下載安裝Git

Windows:msysgit,安裝時需要允許自動進入path環境,不然還得自己配置環境變數
MacOS(如果已安裝XCode可跳過安裝git這步,XCode已整合git):終端執行以下命令

# 安裝homebrew包管理器,已有homebrew可跳過這步
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
# 利用homebrew安裝git
$ brew install git

Linux(Ubuntu):終端執行以下命令

$ sudo apt-get install git

配置Git

  • 配置提交者名稱和郵箱:用於確定程式碼提交者的身份
    Windows開啟Git Bash,Mac & Linux開啟普通終端即可。執行以下命令:
# 後面的有戶名和郵箱請替換為自己的
$ git config --global user.name "michaelx"
$ git config --global user.email michaelx@michaelx.tech
  • 配置ssh公/金鑰:用於本地和Github網站間的安全通訊
# cd進入自己使用者目錄下
# Windows使用者
$ cd C:/Users/michaelx
# Mac & Linux使用者
$ cd ~

# 生成一對ssh鑰匙:公鑰和金鑰。
$ ssh-keygen -t rsa -b 4096 -C "[email protected]"
# 接著幾個回車即可。cd進入.ssh目錄
$ ssh-add id_rsa
# 將.ssh下的id_rsa.pub公鑰檔案用編輯器或者vim開啟,command/Ctrl + C複製裡面的所有文字內容到貼上板
  • 驗證Github訪問許可權
$ ssh -T git@github.com
# 出現以下提示,代表ssh公/金鑰配置ok。需要輸入2次yes
The authenticity of host 'github.com (192.30.252.1)'can't be established.RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.Are you sure you want to continue connecting (yes/no)? # yes

The authenticity of host 'github.com (192.30.252.1)'can't be established.RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.Are you sure you want to continue connecting (yes/no)? # yes

Hi michaelx(username)! You've successfully authenticated, but GitHub does not provide shell access.

假如有兩個場景:
1. 電腦中有一個專案想要上傳到Github
2. Github上fork了一個專案想要自己修改後更新網上的程式碼

以下分兩種請情況分別介紹。

建立一個新的專案

你在本地電腦上有一個專案了,想要上傳到Github上共享或者僅僅是方便版本控制,你需要依次進行如下操作。

  • 在Github新建一個倉庫repo存放專案程式碼
    個人Github主頁,點選:右上角加號->New repository,進入新建倉庫步驟,下圖以建立一個名為”test”的Android專案倉庫為例:

  • 將本地專案檔案上傳
    先下載clone建立的專案到本地:

$ git clone git@github.com:xiong-it/test.git

將待提交的專案檔案全部拷貝test目錄下面。執行下面命令即可提交了:

$ cd test
$ git add . # ‘.’號表示新增該目錄下所有待提交檔案到追蹤區
$ git commit -m "提交說明文字:第一次提交"
$ git push # 提交檔案到test倉庫的master分支

維護一箇舊的專案

這個相比以上新的專案就簡單些了,先git clone下來程式碼,修改完後git addgit commitgit push3步走就行了。

結束語

本篇Github簡明使用教程,希望大家喜歡,幫助到一些Github新手成功託管自己的專案到Github上。

參考