GitHub 新手使用手冊

注: 文章摘自偷偷有碼 - 博客園

GitHub是基於git實現的代碼託管。git是目前最好用的版本控制系統了，非常受歡迎，比之svn更好。

GitHub可以免費使用，並且快速穩定。即使是付費帳戶，每個月不超過10美刀的費用也非常便宜。

利用GitHub，你可以將項目存檔，與其他人分享交流，並讓其他開發者幫助你一起完成這個項目。優點在於，他支持多人共同完成一個項目，因此你們可以在同一頁面對話交流。

創建自己的項目，並備份，代碼不需要保存在本地或者服務器，GitHub做得非常理想。

學習Git也有很多好處。他被視爲一個預先維護過程，你可以按自己的需要恢復、提交出現問題,或者您需要恢復任何形式的代碼，可以避免很多麻煩。Git最好的特性之一是能夠跟蹤錯誤，這讓使用Github變得更加簡單。Bugs可以公開，你可以通過Github評論，提交錯誤。

在GitHub頁面，你可以直接開始，而不需要設置主機或者DNS。

對於我來說，我可以在公司和家編輯同樣的一套代碼了，用U盤或者網盤都好麻煩的說

理論說太多容易忘，來實踐實踐吧。

一. 創建 github repository(倉庫)

1. 登錄 github

2. 創建 repository(倉庫)

爲啥要叫 repository(倉庫)？我起初也納悶，叫代碼庫不更簡單明瞭麼？但仔細一琢磨，倉庫一般都是放糧食的吧，這是把代碼當作飽腹之物，多有愛，瞬間覺得這冰冷冷的代碼充滿了查克拉。

扯遠了，來看怎麼創建倉庫

看到右上角 "+" 沒? 點擊選擇 "New repository"

下面是創建倉庫信息，只有名字是必填項

創建成功後，可以看到自己的倉庫地址。它還介紹了github倉庫的常用指令, 這個指令需要在本地安裝 git 客戶端

　　git init // 把這個目錄變成Git可以管理的倉庫
　　git add README.md // 文件添加到倉庫
　　git add . // 不但可以跟單一文件，還可以跟通配符，更可以跟目錄。一個點就把當前目錄下所有未追蹤的文件全部add了 
　　git commit -m "first commit" // 把文件提交到倉庫
　　git remote add origin [email protected]:wangjiax9/practice.git // 關聯遠程倉庫
　　git push -u origin master // 把本地庫的所有內容推送到遠程庫上

二. 安裝 git 客戶端

1. 下載 git

2. 安裝客戶端

選擇安裝路徑，千萬別選帶中文的路徑，有時候會引起不必要的誤會

選擇安裝組件，按默認的來就好了

1）圖標組件(Addition icons) : 選擇是否創建快速啓動欄圖標或者是否創建桌面快捷方式;
2）桌面瀏覽(Windows Explorer integration) : 瀏覽源碼的方法, 單獨的上下文瀏覽只使用bash 或者只用Git GUI工具; 高級的上下文瀏覽方法使用git-cheetah plugin插件;
3）關聯配置文件(Associate .git*) : 是否關聯git配置文件, 該配置文件主要顯示文本編輯器的樣式;
4）關聯shell腳本文件(Associate .sh) : 是否關聯Bash命令行執行的腳本文件;
5）使用TrueType編碼 : 在命令行中是否使用TruthType編碼, 該編碼是微軟和蘋果公司制定的通用編碼;

設置開始菜單中快捷方式的目錄名稱，默認就好，下一步吧

設置環境變量 : 選擇使用什麼樣的命令行工具, 一般情況下我們默認使用Git Bash即可, 默認選擇;
1）Git自帶 : 使用Git自帶的Git Bash命令行工具;
2）系統自帶CMD : 使用Windows系統的命令行工具;

3）二者都有 : 上面二者同時配置, 但是注意, 這樣會將windows中的find.exe 和 sort.exe工具覆蓋, 如果不懂這些儘量不要選擇;

選擇換行格式，依然是默認就好。
1）檢查出windows格式轉換爲unix格式 : 將windows格式的換行轉爲unix格式的換行在進行提交;
2）檢查出原來格式轉爲unix格式 : 不管什麼格式的, 一律轉爲unix格式的換行在進行提交;
3）不進行格式轉換 : 不進行轉換, 檢查出什麼, 就提交什麼;

選擇終端模擬器，依然默認就好
1）使用MinTTY，就是在Windows開了一個簡單模擬Linux命令環境的窗口Git Bash
2）使用windows的系統的命令行程序cmd.exe

選擇默認就好，不用文件系統緩存

安裝ing...

安裝成功

3. 綁定用戶

打開git-bash.exe，在桌面快捷方式/開始菜單/安裝目錄中
因爲Git是分佈式版本控制系統，所以需要填寫用戶名和郵箱作爲一個標識，用戶和郵箱爲你github註冊的賬號和郵箱
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
注: [email protected] 的部分請改成你在創建賬戶時用的郵箱地址

這個命令會在 C:\Users\Administator （Administator爲電腦用戶名，每個人不同）目錄下生成 .gitconfig 文件

PS: 下面代碼是爲了記住用戶名和密碼, 不用每次都輸入, 需要的直接添加保存即可

[credential]
    helper = store

當然, 還有其他方法保存, 可以直接在git bash 中執行命令：

記住密碼十五分鐘
git config --global credential.helper cache
自定義記住的時間 (單位: 秒)
git config credential.helper 'cache --timeout=3600'
永久記住
git config --global credential.helper store

最後再輸入一次賬號密碼就可以保存了

三. 爲 Github 賬戶設置 SSH key

衆所周知 ssh key 是加密傳輸。

加密傳輸的算法有好多，git 使用 rsa，rsa 要解決的一個核心問題是，如何使用一對特定的數字，使其中一個數字可以用來加密，而另外一個數字可以用來解密。這兩個數字就是你在使用 git 和 github 的時候所遇到的 public key 也就是公鑰以及 private key 私鑰。

其中，公鑰就是那個用來加密的數字，這也就是爲什麼你在本機生成了公鑰之後，要上傳到 github 的原因。從 github 發回來的，用那公鑰加密過的數據，可以用你本地的私鑰來還原。

如果你的 key 丟失了，不管是公鑰還是私鑰，丟失一個都不能用了，解決方法也很簡單，重新再生成一次，然後在 github.com 裏再設置一次就行

1. 生成 SSH Key

首先檢查是否已生成密鑰 cd ~/.ssh
ls 如果有3個文件，則密鑰已經生成，id_rsa.pub 就是公鑰

也可以打開我的電腦 C:\Users\Administator.ssh （Administator爲電腦用戶名，每個人不同）裏面找到

如果沒有生成，那麼通過 $ ssh-keygen -t rsa -C “[email protected]” 來生成
注: [email protected] 的部分請改成你在創建賬戶時用的郵箱地址

1）是路徑確認，直接按回車存默認路徑即可
2）直接回車鍵，這裏我們不使用密碼進行登錄, 用密碼太麻煩;
3）直接回車鍵

生成成功後，去對應目錄 C:\Users\Administator.ssh （Administator爲電腦用戶名，每個人不同）用記事本打開 id_rsa.pub，得到 ssh key公鑰

2. 爲 github 賬號配置 ssh key

切換到 github，展開個人頭像的小三角，點擊settings

然後打開 SSH and GPG keys 菜單，點擊 Add SSH key 新增密鑰，填上標題，跟倉庫保持一致吧，好區分
接着將 id_rsa.pub 文件中 key 粘貼到此，最後 Add SSH key 生成密鑰

如此，github賬號的SSH keys配置完成

四. 上傳本地項目到 github

創建一個本地項目
建立本地倉庫
再來複習一下創建新倉庫的指令：

　　git init // 把這個目錄變成Git可以管理的倉庫
　　git add README.md // 文件添加到倉庫
　　git add . // 不但可以跟單一文件，還可以跟通配符，更可以跟目錄。一個點就把當前目錄下所有未追蹤的文件全部add了 
　　git commit -m "first commit" // 把文件提交到倉庫
　　git remote add origin [email protected]:wangjiax9/practice.git // 關聯遠程倉庫
　　git push -u origin master // 把本地庫的所有內容推送到遠程庫上

首先，進入到 beautifulDay 項目目錄，還記得創建倉庫成功後的那個頁面吧，指令都在呢
然後執行指令：git init