Windows 上 GitHub Desktop 的操作

未經博主允許不得轉載。

目 錄

第1章 上傳開源代碼至GitHub    1

1.1 git Windows 客戶端    1

1.2 注冊GitHub賬戶    2

1.3 登錄    2

1.4 創建本地代碼倉庫    2

1.5 創建遠程代碼倉庫    3

1.6 行結束符    5

1.7 提交改動至本地代碼倉庫    7

1.8 同步代碼倉庫    7

1.9 添加文件至本地代碼倉庫    8

1.10 刪除本地代碼倉庫    9

1.11 增加本地代碼倉庫    9

1.12 刪除遠程代碼倉庫    10

第2章 上傳開源代碼至oschina    11

2.1 創建遠程代碼倉庫    11

2.2 SSH KEY    13

2.3 克隆遠程代碼倉庫至本地    14

2.4 其它操作    16

2.5 README.md    16

第1章 上傳開源代碼至GitHub

1.1 Git Windows 客戶端

具有git功能的Windows客戶端軟件有很多，如：git for windows（以前的msysGit）、TortoiseGit、GitHub Desktop（以前的GitHub for Windows）……

筆者對這些客戶端的理解：

1、git for windows

git 原產于 Linux，要在 Windows 上運行，需要移植。git for windows就是一個這樣的移植項目。它移植的不僅僅是一個程序，而是在 Windows 上模擬出了一個 linux 環境。

git for windows 的下載網址為https://git-for-windows.github.io/，最新版本為2.10.2。它有兩種運行方式：命令行方式（專家使用）、圖形界面方式（菜鳥使用）。不過，它的圖形界面方式操作起來還是比較麻煩，所以筆者沒有選用它。

git for windows是一個開源項目，瀏覽https://github.com/msysgit/msysgit可下載源代碼。

2、TortoiseGit

TortoiseGit只是一個圖形界面程序，它內部調用的還是git for windows。所以，使用TortoiseGit之前需要安裝git for windows。

TortoiseGit最大的優勢在于與TortoiseSVN的操作比較相同，熟悉SVN的用戶可快速上手。

3、GitHub Desktop

GitHub Desktop 跟TortoiseGit一樣，內部也會調用git for windows。不過筆者認為它的操作是這三款軟件中最簡單的，安裝之后無需配置就可使用，非常適合菜鳥。

GitHub Desktop的下載網址為：https://desktop.github.com/。下載下來的文件GitHubSetup.exe是一個在線安裝程序，有可能無法正常安裝。為此，可下載離線安裝包，其網址為http://pan.baidu.com/s/1Hkewm。下載GitHub_3_0_5_2.zip，解壓后運行GitHub.application即可安裝。

注意：如果離線安裝程序無法運行，就需要先安裝.NET Framework 4.5。可先運行在線安裝程序GitHubSetup.exe，安裝.NET Framework 4.5。然后再運行離線安裝程序。

1.2 注冊GitHub賬戶

要上傳開源代碼至GitHub.com，需要在該網站上注冊一個賬戶。請瀏覽網站https://github.com/，單擊"Sign up"按鈕注冊賬戶。操作比較簡單，就不再贅述了。

1.3 登錄

安裝好GitHub Desktop后，第一次運行時需要輸入GitHub.com的用戶名和密碼，如下圖所示：

圖1.1

上圖中，輸入用戶名和密碼后，單擊"Log in"按鈕完成登錄。

1.4 創建本地代碼倉庫

單擊GitHub Desktop主界面左上角的按鈕"+"，將顯示如下界面：

圖1.2

單擊"Create"按鈕，輸入"Name"和"Local path"后單擊"Create repository"按鈕，完成本地代碼倉庫的創建。

如下圖所示，創建本地代碼倉庫的實質就是：1）根據上圖的設置，創建目錄W:\(yhf)\git\GitHub\test；2）在該目錄下生成兩個文件.gitattributes和.gitignore；3）在該目錄下執行 git init命令，生成.git目錄（該目錄是隱藏目錄）。

圖1.3

1.5 創建遠程代碼倉庫

如下圖所示。GitHub Desktop里首先選中上一節創建的本地代碼倉庫test，然后單擊右上角的"Publish"按鈕。

圖1.4

顯示如下界面

圖1.5

"Name"是遠程代碼倉庫的名稱；"Description"是對該項目的描述。單擊"Publish test"按鈕，將完成遠程代碼倉庫的創建，并把本地代碼倉庫里的內容上傳給遠程代碼倉庫。

這個遠程代碼倉庫在github.com上，如下圖所示：

圖1.6

1.6 行結束符

將本地代碼倉庫里的文件上傳給遠程代碼倉庫時，git非常智能：會自動把Windows的行結束符\r\n（即0DH、0AH）替換為\n。關于這一點，VC++.NET表示無所謂，VC++6.0很受傷（無法解析.dsp和.dsw文件）。為了防止git對行結束符的自動改動，需要修改兩個文件。

在 Windows 7 上，修改文件C:\Users\Administrator\.gitconfig（Administrator是登錄Windows時的用戶名）。增加配置項 autocrlf 和 safecrlf。如下所示：

圖1.7

注意：

1、該文件的行結束符為\n，即0AH。所以，筆者使用UltraEdit編輯它，而不是Windows系統自帶的記事本；

2、autocrlf和safecrlf前面的空格其實是一個TAB（09H）字符；

3、這個文件只用修改一次即可。

修改本地代碼倉庫里的文件.gitattributes，可使用記事本，如下圖所示：

圖1.8

上圖中，請將text=auto中的auto刪除，然后保存。

1.7 提交改動至本地代碼倉庫

上一節，修改了本地代碼倉庫里的文件.gitattributes。這個改動應該提交給本地代碼倉庫（其實就是修改本地代碼倉庫.git目錄內的文件）。具體操作如下：

如下圖所示。GitHub Desktop里首先選中代碼倉庫test，然后進入"? uncommitted changes"頁面。輸入提交信息后，單擊"Commit to master"按鈕。

圖1.9

GitHub Desktop主界面下方出現下圖所示提示時，說明提交完成。

圖1.10

1.8 同步代碼倉庫

上一節將改動提交給了本地代碼倉庫。通過"同步"操作，可以將這種改動提交給遠程代碼倉庫。

如下圖所示，單擊GitHub Desktop主界面右上角的"Sync"按鈕即可。

圖1.11

1.9 添加文件至本地代碼倉庫

把代碼文件復制到本地代碼倉庫所在文件夾內，如下圖所示：

圖1.12

然后按照1.7、1.8節的操作，將這些文件提交給遠程代碼倉庫。

1.10 刪除本地代碼倉庫

以刪除本地代碼倉庫test為例進行說明。如下圖所示，鼠標右鍵單擊"test"，彈出菜單中，單擊【Remove】菜單項，即可將test從GitHub Desktop倉庫列表中刪除。

圖1.13

上面的刪除只是將test從GitHub Desktop倉庫列表中移除，物理刪除本地倉庫需要刪除圖1.3所示的文件夾W:\(yhf)\git\GitHub\test。

1.11 增加本地代碼倉庫

上一節中將test從GitHub Desktop倉庫列表中移除，實際的本地倉庫并沒有刪除。此時，就可以增加本地倉庫。如下圖所示：

圖1.14

經此操作后，test將被增加至GitHub Desktop的倉庫列表中。

1.12 刪除遠程代碼倉庫

瀏覽遠程代碼倉庫的地址，如：https://github.com/hanford77/test，然后進入設置頁面，單擊"Delete this repository"按鈕即可。

第2章 上傳開源代碼至oschina

GitHub Desktop管理GitHub.com上的遠程代碼倉庫比較方便，換成其他的git服務器，操作起來會有所不同。如：GitHub Desktop無法在oschina上創建遠程代碼倉庫。本章將重點說明如何將開源代碼上傳至oschina。

2.1 創建遠程代碼倉庫

登錄網站http://git.oschina.NET，注冊賬戶后創建一個項目，頁面顯示如下：

圖2.1

開源許可證的選擇請參考下圖（來自博客http://www.ruanyifeng.com/blog/2011/05/how_to_choose_free_software_licenses.html）。

圖2.2

單擊圖2.1中的"創建"按鈕，完成項目的創建。如下圖所示：

圖2.3

單擊上圖的"SSH"，然后單擊右端的復制按鈕，將項目的網址（git@git.oschina.net:hanford/test.git）復制到剪貼板內。

注意：也可以單擊HTTPS，然后復制項目的https網址。這種網址的麻煩之處在于：本地代碼倉庫與遠程代碼倉庫同步時，會要求輸入用戶名和密碼。

2.2 SSH KEY

上一節復制了項目的SSH地址：git@git.oschina.Net:hanford/test.git。使用SSH，本機與遠程電腦通訊時同樣需要認證（輸入用戶名和密碼），為了簡化認證，可使用SSH KEY。

使用SSH KEY前，它是需要創建的。無需使用git命令行，GitHub Desktop已經為你做好了這一切。進入C:\Users\Administrator\.ssh（Administrator是登錄Windows時的用戶名）如下圖所示：

圖2.4

github_rsa、github_rsa.pub 是GitHub Desktop與GitHub.com通訊時需要的私鑰、公鑰。

id_rsa、id_rsa.pub 是GitHub Desktop與其它git服務器通訊時需要的私鑰、公鑰。

記事本打開id_rsa.pub復制公鑰，再將公鑰粘貼到oschina網站，如下所示：

圖2.5

上圖中的第2項隨便填，第3項就是公鑰。單擊"確定"按鈕，完成一個公鑰的添加。

經過上面的配置，GitHub Desktop與oschina服務器通訊時將使用私鑰、公鑰，不再需要輸入用戶名和密碼了。

注意：GitHub.com為什么不需要設置SSH KEY？因為GitHub Desktop已自動把此項工作完成了。（所以，GitHub Desktop真的適合菜鳥）

2.3 克隆遠程代碼倉庫至本地

單擊Windows開始菜單下的【GitHub,Inc】【Git Shell】菜單項，如下所示：

圖2.6

顯示如下命令窗口

圖2.7

進入本地代碼倉庫目錄（W:\(yhf)\git\oschina），然后運行命令

注意：git@git.oschina.net:hanford/test.git就是圖2.3復制的項目地址。

命令執行完畢后，可以看到W:\(yhf)\git\oschina下的本地代碼倉庫test。如下圖所示：

圖2.8

使用1.11節的方法，將這個本地代碼倉庫增加到GitHub Desktop倉庫列表中。如下圖所示：

圖2.9

注意：代碼倉庫test的遠程代碼倉庫不在GitHub.com上，所以test在Other下。

2.4 其它操作

其它操作請參考1.6節（不用修改文件.gitattributes）、1.7節、1.8節、1.9節。

2.5 README.md

oschina上創建遠程代碼倉庫時，默認就會創建文件README.md。它是Markdown 格式的標記語言文件。是對整個項目的說明。

關于.md文件的格式，需要注意：

1、行結束符為\n（0AH）；

2、編碼為UTF-8，不帶BOM；

3、GitHub.com會忽略行結束符。

Markdown 標記語言的使用，請上網查閱相關資料。

本文出自http://blog.csdn.net/hanford/article/details/53065310