前言：最近需要將自己的代碼開源至自己的Github倉庫，然而發(fā)現(xiàn)并沒有一鍵上傳文件夾的選項(xiàng)，于是參考現(xiàn)有教程進(jìn)行了實(shí)踐，成功??以下是詳細(xì)步驟。

Tips：在文章錄用之后，小伙伴們可以選擇將自己的代碼開源，便于同行更加方便地開展學(xué)術(shù)研究。

準(zhǔn)備工作：Github端

1. 注冊(cè) Github 賬號(hào)

在 https://github.com/join 注冊(cè)一個(gè)賬號(hào)，已有賬號(hào)的同學(xué)跳過本步驟。

2. 新建 Github 倉庫

步驟一：登錄Github網(wǎng)站，打開網(wǎng)址 https://github.com/，按照如下步驟操作：

步驟二：來到如下界面，填寫相應(yīng)信息，最后點(diǎn)擊Create Repository完成Github新倉庫的創(chuàng)建。

至此，Github端的準(zhǔn)備工作就做好啦！接下來我們進(jìn)入本地操作。

準(zhǔn)備工作：本地端

1. 安裝 Git

注：已安裝Git的同學(xué)忽略此步驟。

在 https://git-scm.com/downloads 下載Git，Mac系統(tǒng)需要安裝MacOS版本。

這里我使用第一種方法，即借助Homebrew來安裝Git，所以第一步就是安裝Homebrew.

步驟一：安裝 homebrew。參考網(wǎng)址： https://brew.sh/

具體操作：打開Mac終端，運(yùn)行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝成功界面：

步驟二：安裝 Git。參考網(wǎng)址：https://git-scm.com/download/mac

具體操作：Mac終端繼續(xù)運(yùn)行以下命令：

brew install git

安裝后，使用git --version命令查看Git版本，輸出對(duì)應(yīng)版本說明安裝成功，對(duì)應(yīng)界面如下：

2. 創(chuàng)建本地項(xiàng)目倉庫

步驟一：在本地項(xiàng)目所在路徑下打開終端，或使用cd pj_path命令將終端切換至本地項(xiàng)目所在路徑，其中pj_path為本地項(xiàng)目所在路徑，這里我的本地項(xiàng)目所在的絕對(duì)路徑是/Users/meilinger/Desktop/ICB，ICB是我的本地項(xiàng)目名稱。

步驟二：使用git init命令初始化本地倉庫，該步驟執(zhí)行后，本地項(xiàng)目的根目錄下會(huì)出現(xiàn)一個(gè)名為.git的隱藏文件夾。（PS：使用快捷鍵Command + Shift + .三鍵可以查看隱藏文件）

重磅！本地端&Github端聯(lián)合操作

前面的操作中，本地端和Github端均為準(zhǔn)備工作，二者無先后之分，下面的才是重頭戲～

1. 配置 SSH 與 git config

總攬：首先在本地生成SSH key（步驟一 ?? 步驟三），然后在Github官網(wǎng)將SSH key添加至SSH key列表中（步驟四）。

步驟一：在終端輸入ssh-keygen -t rsa -C email_address命令，其中email_address為注冊(cè)Github時(shí)使用的郵箱。（注意??：如果Github綁定了多個(gè)郵箱，這里填寫主郵箱。）回車，進(jìn)入下一步驟。

步驟二：輸入SSH key的生成路徑。我這里將SSH key的保存路徑設(shè)置為/Users/meilinger/.ssh/id_rsa_ICB，可以看到，為便于記憶，將本地項(xiàng)目名稱ICB添加至路徑結(jié)尾～注意：如果直接回車，SSH key將會(huì)保存至系統(tǒng)提供的默認(rèn)路徑中（這里我的默認(rèn)生成路徑地址為/Users/meilinger/.ssh/id_rsa）。如果當(dāng)前路徑下已經(jīng)存在同名key，可以選擇重寫與否?；剀?，輸入密碼+回車+確認(rèn)密碼+回車。直接回車就是沒有密碼。

至此，SSH key已經(jīng)生成啦～

步驟三：在終端執(zhí)行命令pbcopy < ~/.ssh/id_rsa_demo.pub將SSH public key復(fù)制到剪切板，下圖所示界面表示操作成功。

步驟四：回到Github官網(wǎng)，依次點(diǎn)擊賬號(hào)頭像、Settings、SSH and GPG keys以及New SSH key，如圖。

點(diǎn)擊New SSH key后系統(tǒng)會(huì)自動(dòng)跳轉(zhuǎn)至以下界面。在本界面，分別填寫Title和Key字段，這里Title字段我填充的是本地項(xiàng)目名稱，Key字段就是我們剛剛在步驟三中使用命令pbcopy < ~/.ssh/id_rsa_demo.pub復(fù)制的SSH public key. 之后點(diǎn)擊Add SSH key完成添加操作。

接下來回到終端，使用命令ssh -T git@github.com驗(yàn)證是否添加成功，若添加成功，會(huì)出現(xiàn)如下界面：

如果終端返回 Permission denied (publickey) 字段，說明上述SSH key沒有添加成功。解決方法：在終端執(zhí)行命令 ssh-add ~/.ssh/id_rsa_ICB，記得換成自己的SSH key所在路徑。

步驟五：配置git config. 如下圖所示，在終端中，依次輸入命令：

git config --global user.name github_name
git config --global user.email github_email

其中，github_name 為 Github 賬號(hào)對(duì)應(yīng)的名稱，github_email 為Github 賬號(hào)中的主郵箱，即前述步驟中使用的郵箱。

2. 上傳代碼

首先：確保此時(shí)終端當(dāng)前所在路徑為本地項(xiàng)目所在路徑，即.git隱藏文件夾的上級(jí)目錄。

步驟一：執(zhí)行命令git add .，將本地項(xiàng)目中的全部文件添加至git中，命令中.的含義就是“全部文件”。
步驟二：執(zhí)行命令git commit -m "description"，添加項(xiàng)目的描述文字，命令中description就是自定義的描述文字。
步驟三：執(zhí)行命令git remote add origin pj_ssh_path，其中pj_ssh_path可通過下下圖的方式進(jìn)行復(fù)制粘貼，比如我這里的pj_ssh_path為git@github.com:meiling-fdu/ICB.git.

?? PS：此步驟可能會(huì)報(bào)錯(cuò)“錯(cuò)誤：遠(yuǎn)程 origin 已經(jīng)存在。”，解決辦法如圖：

先執(zhí)行命令 git remote rm origin刪除已存在的遠(yuǎn)程配置，然后再執(zhí)行上述命令 git remote add origin pj_ssh_path.

步驟四：執(zhí)行命令git push -f origin master，將本地項(xiàng)目的文件上傳至Github官網(wǎng)中。發(fā)現(xiàn)報(bào)錯(cuò)如下：

根據(jù)本篇博客的內(nèi)容，我發(fā)現(xiàn)，是Github官網(wǎng)上郵箱設(shè)置的相關(guān)問題，即我們?cè)卩]箱設(shè)置頁面中勾選了Keep my email addresses private與Block command line pushes that expose my email這兩個(gè)選項(xiàng)，如下圖所示：

所以第一個(gè)解決方法就是取消上述兩個(gè)勾選??。但如果我們不想取消上述設(shè)置，可通過如下方法解決：

1. 獲取Github的推薦郵箱賬號(hào)?？稍卩]箱設(shè)置頁面中的如上圖所示紫色下劃線位置查看?？梢钥吹轿业耐扑]郵箱賬號(hào)為73975898+meiling-fdu@users.noreply.github.com

2. 執(zhí)行命令git config --global user.email “推薦E-mail” 重置全局用戶E-mail，這里的“推薦E-mail”即為上面的推薦郵箱賬號(hào)。

在終端執(zhí)行命令git config --global user.email，查看全局郵箱賬號(hào)是否修改成功，由下圖可知，全局郵箱賬號(hào)已成功修改。

3. 執(zhí)行命令git commit --amend --reset-author重置作者信息。輸入命令回車后，進(jìn)入vi編輯模式，在英文輸入法下執(zhí)行:wq保存并退出。（如下圖）
   

PS: 若出現(xiàn)如下錯(cuò)誤，根據(jù)本篇博客，解決方法為：執(zhí)行命令git stash，如下圖所示：

PS：若出現(xiàn)如下錯(cuò)誤：

此時(shí)使用git branch -a命令查看所有分支不輸出結(jié)果。根據(jù)本篇博客，解決方法為：執(zhí)行命令git commit -m "xx"，如下圖所示：

然后再使用git branch命令查看本地分支，就可以得到輸出結(jié)果，如下圖：

上述錯(cuò)誤全部排查完畢后，再次執(zhí)行命令git push -f origin master，就可以成功上傳啦！(注意區(qū)分命令git push -f origin master與git push -f origin main～)

至此，刷新GitHub頁面，就可以看到項(xiàng)目已經(jīng)上傳成功啦?。ǜ鶕?jù)本篇博客注意切換至master分支哦～）

后記：之前感覺代碼托管很繁瑣，一直想學(xué)但是因?yàn)椴皇莿傂杷焓唛w。今天用起來才發(fā)現(xiàn)也沒那么難嘛！又掌握了一項(xiàng)技能，果然還是“萬事開頭難”哇，今日收獲：Just do it !

參考資料文章來源地址http://www.zghlxwxcb.cn/news/detail-585675.html

1. 一步一步教你如何在GitHub上上傳自己的項(xiàng)目_github上傳項(xiàng)目_夏雨薇安的博客-CSDN博客
2. [Git]Mac上傳已有項(xiàng)目到GitHub - 簡書 (jianshu.com)
3. git push origin master報(bào)錯(cuò)的解決方法 & 常見git命令（待更新）_王小希ww的博客-CSDN博客
4. git使用——rebase_不能變基式拉取:您有未暫存的變更。_三番魚的博客-CSDN博客
5. [git報(bào)錯(cuò)–>! remote rejected master -> master (push declined due to email privacy restrictions)_淡淡的id的博客-CSDN博客
6. GitHub提交Push之后發(fā)現(xiàn)代碼在Master分支，默認(rèn)main分支沒有代碼_github push main_java勸退師_mysql刪庫師的博客-CSDN博客
7. git branch 不顯示分支_git branch沒有分支-CSDN博客

到了這里，關(guān)于「詳細(xì)教程」使用git將本地項(xiàng)目上傳至Github倉庫（MacOS為例）的文章就介紹完了。如果您還想了解更多內(nèi)容，請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！