前言#
適合系統：linux 和 macos
閱讀本文需要有一定 linux 知識，懂一點 linux 命令。
什麼是 Github?#
要了解什麼是GitHub，首先要了解什麼是Git：
Git（讀音為 /gɪt/）是一個開源的分佈式版本控制系統，可以有效、高速地處理從很小到非常大的項目版本管理。相比於集中式的最大區別在於開發者可以提交到本地，每個開發者通過克隆（git clone），在本地機器上拷貝一個完整的 Git 倉庫。
GitHub：
GitHub 是一個面向開源及私有軟件項目的托管平台，因為只支持 git 作為唯一的版本庫格式進行托管，故名 GitHub。
簡單來說，就是能把你寫的代碼項目在任何設備隨時上傳，可以在任何設備再下載下來，實現多端同步。
正文#
創建你自己的 git 項目倉庫#
註冊 github 後，進入個人賬戶頁面，有個New按鈕。點擊以後創建Repository倉庫。
命名自己能懂即可，最好和你本地的項目文件夾相似，後面會用到，比如我這裡創建的是自己 R 語言學習的內容
本地部署 git#
安裝非常簡單，只要懂一些命令即可。
$ sudo apt install git-all #debian系
$ git --version #macos安裝Xcode Command Line Tools後運行該命令即可。Xcode Command Line Tools的安裝方式也十分簡單，請自行查找。
其餘系統安裝請參考 git 官網：GIT 起步
將機器與 Github 關聯#
相信玩過伺服器的朋友應該都知道 ssh 是什麼。由於 git 是通過 ssh 完成文件上傳下載的，所以需要將一個 ssh 秘鑰文件填到 GitHub，完成你的機器的認證。
$ cd .ssh
如果提示 No such file or directory，說明本機還沒有生成過 sshkey，執行下面的命令
$ ssh-keygen -t rsa -C "你的郵箱地址"
這步運行結束出現長方形字符畫即成功，申請的 sshkey 已經保存在.ssh 文件夾裡了。
之後打開秘鑰文件複製裡面的全部內容：
$ cat ~/.ssh/id_rsa.pub
#或者如果你會用vim
$ vim ~/.ssh/id_rsa.pub
當然也可以直接用文本編輯器打開，.ssh 隱藏文件夾在你的用戶文件夾下。macos 顯示隱藏文件快捷鍵為 Ctrl+shift+.
回到你的 GitHub 用戶頁，點擊右上角，進入 settings，點擊左側 SSH and GPG keys
點擊右上角 newsshkeys，標題隨意，把複製的秘鑰文件內容粘貼進下面的框裡保存，就完成的 GitHub 認證。
完成之後終端通過以下命令確認 SSH key 是否成功
$ ssh -T [email protected]
#最後出現以下內容即成功
Hi 你的用戶名! You've successfully authenticated, but GitHub does not provide shell access.
將項目文件夾進行 git 配置並上傳#
終端通過cd進入你想要同步的項目文件夾，運行如下命令：
$ git init #初始化,這步運行後你的終端會顯示git:(master) ✗
$ git add . #官網給的指導裡寫的是README.md，那只是個示範，是只把README.md這個文件上傳。這裡的意義是同步這個文件夾的所有內容
$ git commit -m "first commit" #引號內的內容是寫你上傳更新的原因
$ git branch -M main
$ git remote add origin https://github.com/你的用戶名/你剛剛設置的倉庫名.git
#忘記倉庫名的話瀏覽器進你倉庫頁面，網址複製下來後面加上.git即可
$ git push -u origin main #push上傳
完成！現在重新進入倉庫頁面，可以看到文件夾下的內容已經在裡面了！
以後只需要 cd 到項目文件夾，執行以下的命令就能上傳更新了。
$ git add .
$ git commit -m "更新原因"
git push -u origin main
若要將雲端代碼同步到本地，命令：
$ git pull --rebase origin master
然後你就可以愉快地把自己的所有項目進行上傳到 github 了！
參考 3y 的文章的部分內容：https://github.com/ZhongFuCheng3y/3y 並作出一定修正改進。