Linux 安裝使用 GitHub 完整指南：SSH 金鑰、Git 設定、專案推送與常見問題

Git 是分散式版本控制系統，GitHub 是基於 Git 的程式碼託管平台。本文記錄 Linux 下安裝 Git、建立 SSH 金鑰、配置 Git 使用者資訊、測試連線、初始化專案並推送至 GitHub 的完整流程，並解決推送被拒絕（需 -f 強制）等常見問題。

1. 註冊 GitHub 帳號並建立倉庫

• 訪問 github.com 註冊/登入。
• 建立新倉庫（Repository），名稱如 test，複製倉庫 URL：https://github.com/username/test.git 或 git@github.com:username/test.git。

2. 安裝 Git

# Debian/Ubuntu
sudo apt-get install git git-core git-doc

# CentOS/RHEL
sudo yum install git

# Fedora
sudo dnf install git

3. 產生 SSH 金鑰並加入 GitHub

ssh-keygen -t rsa -C "your_email@youremail.com"
# 一路 Enter（或設定密語），產生 ~/.ssh/id_rsa (私鑰) 與 id_rsa.pub (公鑰)

cat ~/.ssh/id_rsa.pub
# 複製輸出內容

# 瀏覽器：GitHub → Settings → SSH and GPG keys → New SSH key
# Title 隨意，Key 貼上公鑰內容 → Add key

4. 配置 Git 全域使用者資訊

git config --global user.name "lukeyan"
git config --global user.email "xxx@gmail.com"
# 此資訊會寫入每次提交的作者欄位

5. 測試 SSH 連線

ssh -T git@github.com
# Hi username! You've successfully authenticated, but GitHub does not provide shell access.
# 出現此訊息即代表連線成功

6. 初始化專案並推送

cd /path/to/project
git init
git add .                    # 或指定檔案：git add file1 file2
git commit -m 'version 1.0'
git remote add origin https://github.com/username/test.git
# 或 SSH 方式：git remote add origin git@github.com:username/test.git

git push origin master -f
# -f 強制推送（遠端有 README 等檔案導致歷史不相容時需用）
# 首次推送建議：git push -u origin master

常見問題與解決

進階技巧

• 多帳號切換：~/.ssh/config 設定 Host github.com-user1 指定 IdentityFile。
• GPG 簽署提交：git config --global commit.gpgsign true。
• GitHub CLI：gh repo create、gh pr create 等指令加速工作流。