今天我們介紹的內容為**如何使用 git 命令行上傳項目到 GitHub**，其中會涉及到一些關于 R 包發(fā)布的簡單介紹。其實這篇筆記是因為想要介紹**如何將 R 包上傳分享給他人使用**才有的，而 GitHub 上傳項目步驟都是相同的，不管是 R 包還是其他，所以就正好借這個機會，詳細介紹一下**上傳項目到 GitHub** 啦！

專欄這個格式實在是太?。。∫谎噪y盡?。。。。“?！

如果大家有興趣的話，還是去公眾號看更舒服！或者等我的視頻嘿嘿嘿！?。?/p>

前面我們已經成功開發(fā)了自己的 R 包，如果我們希望把它分享給其他人，允許別人也可以利用你的包（福澤天下?。。。俏覀兛梢园阉l(fā)布出去！一般我們會用到兩大平臺：CRAN 和 GitHub。

1 在 CRAN 上發(fā)布你的包

我們先來簡單介紹一下在 CRAN 上發(fā)布你的包！后續(xù)再詳細介紹在 GitHub 上傳好不好！

將包發(fā)布在 CRAN 上是比較難的一步，因為在成功發(fā)布前要對包進行大量的嚴格測試。除了通過這些測試，你還需要給出關于包的運行的詳盡描述。這些描述將存儲在 vignettes 文件夾中，你可在主項目目錄中創(chuàng)建該文件夾。

當你已確認你的包在本地模擬測試中運行良好并且正常記錄后，你需要進入`Build > Build Source Package`創(chuàng)建源碼包。

在創(chuàng)建完源碼包后，你就可以在 CRAN 上提交發(fā)布這個包的申請啦！

如果你的包在 CRAN 上成功發(fā)布，之后你需要確保不斷更新你的包，以修正某些程序錯誤和/或添加新功能。如果在特定時段內你未對包進行更新，CRAN 就會遺棄你的包喲！

2 在 GitHub 上發(fā)布你的包

接下來就是我們今天的重點啦！在 GitHub 上發(fā)布你的包！

一般來說，在 GitHub 上發(fā)布你的包會相對容易很多。在 GitHub 上發(fā)布包最簡單的方法是創(chuàng)建一個新的倉庫，然后將主文件夾（我們以之前開發(fā)的`xmypkg`包為例）的內容上傳至該倉庫就完成啦！

我們來看具體流程！

首先你需要在 GitHub 上創(chuàng)建一個新的代碼倉庫（Repository），你可以登錄 GitHub，然后點擊”`New`“按鈕來創(chuàng)建新倉庫。

進入創(chuàng)建新倉庫界面，填寫相關信息，點擊”`Create repository`“即可創(chuàng)建成功。

倉庫創(chuàng)建成功后，你會進入這個頁面。

其實，我們可以看到，這個頁面已經告訴我們應該怎么做啦，后面我們就一步一步為大家進行介紹！

1. 首先打開命令行終端，進入你的 R 包項目的根目錄。通過`git init`把它變成 git 倉庫（也可以新建文件夾，把它變成 git 倉庫，之后再把你的項目復制到這個文件夾里面）。

2. 通過`git add .`將所有文件添加到 git 倉庫中，`.`代表當前目錄下的所有文件。如果只想上傳某個文件，只需要在`git add`后加文件名即可，比如上圖中的`git add README.md`。

3. 通過`git commit -m "first commit"`把項目提交到倉庫，引號中可以填寫任何你想要使用的提交消息。

4. 使用命令`git branch -M main`新建分支。

? ? 大家可能會好奇，我們?yōu)槭裁匆陆ǚ种兀?/p>

其實在使用 git 時，創(chuàng)建新的分支可以幫助我們在 git 項目中實現更好的版本控制、并行開發(fā)和團隊協作。它提供了更靈活的工作流程，可以提高開發(fā)效率，并幫助保持代碼庫的整潔和穩(wěn)定。具體好處如下：

a. 并行開發(fā)：通過創(chuàng)建新的分支，我們可以在獨立的分支上進行開發(fā)工作，而不會影響主分支（通常是`master`分支）上的穩(wěn)定代碼。這樣，我們可以同時處理多個任務、修復錯誤或嘗試新功能，而不會破壞主分支的穩(wěn)定性。

b. 版本控制：通過創(chuàng)建新的分支，我們可以輕松管理不同版本的代碼。例如，我們可以為每個發(fā)布版本創(chuàng)建一個分支，這樣我們可以在每個分支上進行相關的修復和調整，同時保留每個版本的代碼狀態(tài)。

c. 特性開發(fā)：創(chuàng)建新的分支可以幫助我們實現特性開發(fā)的流程。我們可以為每個特性或功能創(chuàng)建一個獨立的分支，在該分支上進行開發(fā)和測試。一旦特性開發(fā)完成并經過測試，我們就可以將該分支合并到主分支中。

d. 團隊協作：分支在團隊協作中發(fā)揮著重要作用。團隊成員可以在各自的分支上進行工作，并在完成后將其合并到主分支中。這樣，每個人都可以獨立開發(fā)和測試代碼，而不會相互干擾。

5. 在 Github 上創(chuàng)建好 git 倉庫之后我們就可以和本地倉庫進行關聯啦，根據創(chuàng)建好的 git 倉庫頁面的提示，可以在本地倉庫的命令行輸入`git remote add origin <GitHub 倉庫 URL>`，`<GitHub 倉庫 URL>`為你在第 1 步中創(chuàng)建的倉庫的URL。比如本文的例子，想要上傳開發(fā)的`xmypkg`包，我們就應該輸入下面這行命令：

6. 最后通過`git push -u origin main`把本地倉庫的項目推送（push）到遠程倉庫（也就是 Github）上。

由于新建的遠程倉庫是空的，所以要加上`-u`這個參數，等遠程倉庫里面有了內容之后，下次再從本地庫上傳內容的時候只需`git push origin main`就可以啦！

注：

1. 如果是本地，按照上述步驟直接來就OK啦！但如果你是在服務器上操作 git，就要確保你已經正確地配置了 git 身份驗證（用戶名和電子郵件地址）才可以順利上傳喲！

2. 像我們上面介紹的這樣上傳文件是有大小限制的，如果你想要上傳大文件，就需要借助 Git LFS（Large File Storage, 大文件存儲），下面的鏈接中有你想要的！

完成上述步驟之后，大家就可以使用安裝GitHub上R包的命令安裝并使用這個包啦！如下：

參考資料

1. https://blog.csdn.net/lxd13699/article/details/122384935

2. https://www.cnblogs.com/nkwy2012/p/9066370.html

3. https://www.runoob.com/git/git-commit.html