甚麼是 Git 和 GitHub

• Git 是免費的版本管理軟體，有整合在 VS Code。
• GitHub 以 Git 為核心技術基礎的雲端服務平台，程式碼可以上傳存放分享。

如何在 VS Code 開始使用 GitHub？
下面就簡單扼要地說明使用前，主要安裝和設定步驟。

建立 GitHub 帳戶

建立一個免費的使用者帳戶。 到 http://github.com，點選右上角的「Sign up」，輸入還未被使用過的電子郵件地址，設定密碼和選擇一個獨特的用戶名。跟著導引指示設定，然後按下綠色「Sign up for GitHub」按鈕。

新手的疑問 (Q&A)：

• 如果畢業後或換工作，我是否可以更改這電子郵件地址？
  我是否可以增加其它使用的電子郵件地址？

  自然都可以。登入 GitHub 帳戶 後，點選右上角的帳戶圖像，進入管理頁面的 Emails 區塊，你可以管理、刪除或加入電子郵件地址。

• 在 VS Code 內可否連結多個 GitHub 帳戶？例如 個人、學校或工作有不同的帳戶。
  答案是可以。但詳細步驟就不在這篇文章說明。

安裝 Git

檢查是否有安裝 Git， 在終端機輸入：

git --version

如果還沒有安裝 Git，從 git-scm.com 下載「64-bit Git for Windows Setup」，然後依指示安裝。

初次設定 Git

有兩種方式：

• 在終端機進行設定，輸入：

  git config --global user.name MyName
git config --global user.email MyEmail

  這裡的 MyName 和 MyEmail 是要換成 使用者名稱 和 電子郵件地址。

• 或是從 desktop.github.com 下載安裝 「GitHub Desktop」，在安裝過程，會導引指示去設定你的使用者名稱 和 電子郵件地址。以後也可以在「GitHub Desktop」的 “Options” 設定介面內，更改或確認 你的使用者名稱 和 電子郵件地址。

  但如果想針對單一專案執行不一樣的專案配置，不想使用  git config --global的設定，「GitHub Desktop」就沒有提供設定介面來更改設定。

  只能在終端機進行設定，輸入：
  git config --local user.name AnotherName
git config --local user.email AnotherEmail

建立 SSH 連接到 GitHub.com

除了使用使用者名稱和密碼，經由 HTTPS 和 GitHub 連接外，也可以建立SSH鑰匙文件，經由 SSH (Secure Shell Protocol) 來 讀寫 GitHub 存儲庫 (repository) 的資料。

當透過 SSH 連接時，就會使用本地機器上的一個 SSH 私鑰文件進行身份驗證。

是否已經有SSH密鑰 (SSH keys)？

• 在 VS Code 打開 Git Bash 終端機，輸入：
  ls -al ~/.ssh

• 或 打開 Command Prompt (cmd) 終端機，輸入：
  dir %userprofile%\.ssh

如果有的，就會列出檔案，例如 id_ed25519, id_ed25519.pub 或是 known_host等

生成 SSH密鑰

• 打開終端機，輸入：
  ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

  • -b 設定 key 的長度(bits)
  • -C 新增一個註解，這裡是增加一個 Email 的註解
  • 其他的指令如 -f 指定密鑰的生成名稱 (預設是：id_rsa.pub、id_rsa)

• 或是輸入：(這是 GitHub 建議的方式)
  ssh-keygen -t ed25519 -C "your_email@example.com"

• 輸入完畢後它會先問你 ssh 生成的路徑要在哪裡與是否要設置密碼
  如果沒有要特別調整的話，一直按下 Enter 即可。

  如果電子郵件地址沒有空白或其他特殊符號，可以不加上雙引號 "

取得 SSH 公鑰並新增到 GitHub

• 用你常用文字編輯軟體打開 id_ed25519.pub 檔案，全選內容，複製SSH 公鑰
• 打開 GitHub.com 網頁， 點擊右上角的帳戶圖像，點選 Settings
• 在側邊欄找到「SSH and GPG keys」
• 頁面上方有一個 SSH keys，旁邊有一個按鈕「New SSH key」
• 在「Add new 頁面，Title 欄位可以隨意填寫, 如電腦名稱，而底下 Key 欄位 就貼上 剛複製的SSH 公鑰
• 點擊下方的綠色 「Add SSH key」

終於，我們可以在 VS Code 更自然使用 GitHub，不用輸入密碼喔。

Git和GitHub 的傳送門

🌐 Introduction to Git in Visual Studio Code
🌐 Source Control with Git in Visual Studio Code
🌐 Git - 初次設定 Git
🌐 Checking for existing SSH keys - GitHub Docs
🌐 Adding a new SSH key to your GitHub account - GitHub Docs