快轉到主要內容
  1. 教學文章/

GitHub 指令工具

·2 分鐘· loading · loading · ·
版本控制 Git 指令模式 Github
每日拍拍
作者
每日拍拍
科學家 X 科技宅宅
目錄
版本控制: Git - 本文屬於一個選集。
§ 3: 本文

GitHub Command Line Tool
#

隨著 GitHub 已成為全球最大的程式碼協作平台,開發者每天都在處理各種 issue、pull request、r 管理等繁雜工作。如果每次都必須透過瀏覽器操作,切換視窗、點擊滑鼠,不僅耗時也容易分心。

這時候,gh ——GitHub 官方推出的命令列工具(GitHub CLI)就成為提升效率的神器。有了 gh 指令模式,你可以直接在終端機下完成大部分常見的 GitHub 操作

安裝套件
#

Windows 使用者
#

  1. 透過 Chocolatey 安裝
choco install gh
  1. 透過 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 帳號
#

Warning! 需要先設置 SSH 金鑰。

如果你還沒有設置 SSH 金鑰可以閱讀本文 來設置。

首次使用時,請先輸入以下指令登入 GitHub:

gh auth login

來登入 GitHub:

auth login 1

這邊選 GitHub.com。

auth login 2

接著選擇連線方式:HTTPS 或 SSH。建議使用 SSH,需先建立 SSH 金鑰。

要快速建立SSH 金鑰,可以在終端機直接輸入:

   ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

然後一直按 Enter 使用預設的選項就可以創立。

若選用 HTTPS,每次操作會需要頻繁輸入帳號密碼,較為不便。

auth login 3

接著輸入你的 SSH public key 的檔名(預設是用~/.ssh/id_rsa.pub)。

auth login 4

輸入你目前使用的機器暱稱。譬如你如果是使用筆電的話,你可以取名 laptop 幫助自己管理有哪些機器使用 gh

auth login 5

接著可以選擇透過瀏覽器登入(或是使用其他的訪問權杖, token)。

auth login 6

在網頁輸入終端機提供的一次性登入碼後就完成登入授權了。

使用 gh 創建 repo
#

在剛剛初始化的本地 git 專案資料夾中輸入:

gh repo create

repo create

依照畫面指示完成,就能將本地 git 專案與 GitHub 雲端倉庫串接起來。

Push
#

記得在 git push 之前要設定上游是 GitHubmain branch 喔:

git push --set-upstream origin main

接下來就可以依照標準 git 流程操作。例如新增 .gitignore 檔案:

# ./.gitignore

*.pyc
**/.DS_Store

編輯好想加入的檔案後,依序執行:

git add .
git commit -m "initial commit"
git push

這樣就大功告成啦!

參考文獻
#

版本控制: Git - 本文屬於一個選集。
§ 3: 本文

相關文章

版本控制軟體 Git - 安裝篇
·3 分鐘· loading · loading
版本控制 Git