往 GitHub 推送代碼時需要通過身份驗證,通常有兩種方式:
兩種都能用,但個人更推薦 SSH 秘鑰。一次配置之後長期受益,不必反覆輸入賬號密碼,實際用起來你就明白好在哪裡了。下面只講 SSH 秘鑰的配置。
登錄 GitHub 後,點右上角頭像進入 Settings,在左側菜單選擇 SSH and GPG keys,然後點 New SSH key。Title 隨便填(一般寫上機器名或 GitHub 賬號),Key 處粘貼公鑰內容即可。
如果之前配置過,這個頁面會列出已有的秘鑰。
秘鑰存放在用戶目錄下的 .ssh 目錄,其中公私鑰分別是 id_rsa 和 id_rsa.pub。打開終端確認:
ls -al ~/.ssh
如果輸出裡能看到 id_rsa 這類文件,說明秘鑰已經生成過:
RunIntoLoveMacBook-Pro:~ yuewen$ ls -al ~/.ssh total 40 drwxr-xr-x 6 yuewen staff 204 11 30 17:40 . drwxr-xr-x+ 35 yuewen staff 1190 4 6 12:47 .. -rw-r--r--@ 1 yuewen staff 6148 12 9 12:12 .DS_Store -rw------- 1 yuewen staff 3326 1 6 14:08 id_rsa -rw------- 1 yuewen staff 742 1 6 14:08 id_rsa.pub -rw-r--r-- 1 yuewen staff 2794 2 29 18:09 known_hosts
這種情況只需把公鑰內容複製出來,粘到 GitHub 的配置頁即可。一條命令搞定:
pbcopy < ~/.ssh/id_rsa.pub
依次在終端執行:
1. 生成新的 SSH 秘鑰
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
2. 確認保存路徑(默認即 id_rsa,直接回車)
Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]
3. 設置密碼短語(直接回車表示留空)
Enter passphrase (empty for no passphrase): [Type a passphrase] Enter same passphrase again: [Type passphrase again]
4. 啟動 ssh-agent
eval "$(ssh-agent -s)"
5. 把私鑰加入 agent
ssh-add ~/.ssh/id_rsa
6. 複製公鑰,方法同上一節。
上傳有兩條路:Xcode 圖形界面,或者終端命令行。
點擊 New repository,填寫倉庫信息後 Create repository。創建完成頁面會給出一個 SSH 形式的倉庫地址,後面配置時要用到它。
把項目文件夾拖進終端即可自動定位路徑,然後依次執行:
1. 添加遠程倉庫
git remote add origin '你的SSH倉庫地址'
2. 提交本地修改
git commit -m "第一次提交"
3. 推送到遠程
git push -u origin master // 輸出示例 Counting objects: 9, done. Delta compression using up to 8 threads. Compressing objects: 100% (7/7), done. Writing objects: 100% (9/9), 1.49 KiB | 0 bytes/s, done. Total 9 (delta 4), reused 0 (delta 0) To git@github.com:YRunIntoLove/GitHubTest.git 0610732..90508d7 master -> master Branch master set up to track remote branch master from origin.
4. 刷新 GitHub 確認,上傳成功。
整套流程裡真正需要記住的只有三件事:公鑰(id_rsa.pub)粘到 GitHub、遠程地址(SSH 形式)配到本地、以及推送前先 Pull 避免衝突。剩下的都是一次性操作。