GitHub Command Line Tool #
隨著 GitHub 已成為全球最大的程式碼協作平台,開發者每天都在處理各種 issue、pull request、r 管理等繁雜工作。如果每次都必須透過瀏覽器操作,切換視窗、點擊滑鼠,不僅耗時也容易分心。
這時候,gh
——GitHub 官方推出的命令列工具(GitHub CLI)就成為提升效率的神器。有了 gh
指令模式,你可以直接在終端機下完成大部分常見的 GitHub 操作
安裝套件 #
Windows 使用者 #
- 透過 Chocolatey 安裝
choco install gh
- 透過 Scoop 安裝
scoop install gh
Mac 使用者 #
brew install git
brew install gh
專案初始化 #
先建立專案的資料夾:
mkdir myrepo
cd myrepo
創立一個 local git
repo
git init
如果你用較舊版本的 git 或希望主要分支為 main
,可以用
git init -b main
授權你的 GitHub 帳號 #
如果你還沒有設置 SSH 金鑰可以閱讀本文 來設置。
首次使用時,請先輸入以下指令登入 GitHub:
gh auth login
來登入 GitHub:
這邊選 GitHub.com。
接著選擇連線方式:HTTPS 或 SSH。建議使用 SSH,需先建立 SSH 金鑰。
要快速建立SSH 金鑰,可以在終端機直接輸入:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
然後一直按 Enter 使用預設的選項就可以創立。
若選用 HTTPS,每次操作會需要頻繁輸入帳號密碼,較為不便。
接著輸入你的 SSH public key 的檔名(預設是用~/.ssh/id_rsa.pub
)。
輸入你目前使用的機器暱稱。譬如你如果是使用筆電的話,你可以取名 laptop
幫助自己管理有哪些機器使用 gh
。
接著可以選擇透過瀏覽器登入(或是使用其他的訪問權杖, token)。
在網頁輸入終端機提供的一次性登入碼後就完成登入授權了。
使用 gh 創建 repo #
在剛剛初始化的本地 git 專案資料夾中輸入:
gh repo create
依照畫面指示完成,就能將本地 git 專案與 GitHub 雲端倉庫串接起來。
Push #
記得在 git push
之前要設定上游是 GitHub
的 main
branch 喔:
git push --set-upstream origin main
接下來就可以依照標準 git 流程操作。例如新增 .gitignore
檔案:
# ./.gitignore
*.pyc
**/.DS_Store
編輯好想加入的檔案後,依序執行:
git add .
git commit -m "initial commit"
git push
這樣就大功告成啦!