一、Git 基礎配置

# 設置全局用戶名和郵箱（用于提交記錄）
git config --global user.name "Your Name"
git config --global user.email your.email@example.com
# 生成SSH密鑰（用于免密連接Git服務器）
ssh-keygen -t rsa -C "your.email@example.com"
# 按提示連續回車即可，無需設置密碼
# 查看并復制公鑰
cat ~/.ssh/id_rsa.pub

將生成的公鑰添加到 GitLab/GitHub：
頭像 → Settings → SSH Keys → 粘貼公鑰 → Add Key

二、Git 代碼提交流程

2.1 克隆遠程倉庫

git clone git@github.com:username/repo.git  # SSH方式（推薦）
# 或使用HTTPS方式
git clone https://github.com/username/repo.git

2.2 創建并切換分支

# 創建新分支并切換到該分支
git checkout -b new-feature
# 等價于以下兩條命令
git branch new-feature  # 創建分支
git checkout new-feature  # 切換分支

2.3 暫存文件

git add filename  # 添加單個文件
git add .  # 添加所有修改的文件（不推薦，容易提交無關文件）
git add -p  # 交互式添加（推薦，精確控制暫存內容）

2.4 提交到本地倉庫

# 標準提交格式（推薦）
git commit -m "feat: 實現用戶登錄功能"
# 完整提交規范（可選）
git commit -m "type(#issue): 描述"

以下為提交類型說明的表格形式呈現：

類型	說明	示例
feat	新增功能	feat (#123): 添加支付模塊
fix	修復 Bug	fix (#456): 解決登錄異常
docs	文檔更新	docs: 更新 README
style	格式調整（不影響功能）	style: 統一代碼縮進
refactor	代碼重構（非新增/修復）	refactor: 優化數據庫查詢
perf	性能優化	perf: 提升響應速度
test	添加測試用例	test: 補充單元測試
chore	構建/工具鏈更新	chore: 升級依賴版本

2.5 拉取遠程最新代碼

# 在主分支更新
git pull origin main
# 在開發分支更新
git pull origin new-feature

2.6 推送本地分支到遠程

git push origin new-feature
# 首次推送可設置上游分支（簡化后續推送）
git push -u origin new-feature

三、VSCode 服務器免密登錄配置

3.1 生成 Windows SSH 密鑰

# 在Windows命令行（Git Bash）中執行
ssh-keygen -t rsa -C "your.email@example.com"

密鑰文件位置：C:\Users\YourName.ssh\id_rsa.pub

3.2 復制公鑰到服務器

# 1. 查看Windows公鑰內容
cat C:\Users\YourName\.ssh\id_rsa.pub
# 2. 登錄Linux服務器，創建/編輯授權文件
vi ~/.ssh/authorized_keys
# 3. 將Windows公鑰內容粘貼到該文件中

3.3 設置文件權限（關鍵！）

# 確保SSH目錄和授權文件權限正確
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

3.4 在 VSCode 中驗證連接

1. 安裝 Remote-SSH 擴展
2. 點擊左下角遠程圖標 → Connect to Host
3. 輸入服務器配置（如ssh username@server_ip）
4. 選擇私鑰文件（Windows 路徑 C:\Users\YourName.ssh\id_rsa）

四、常見問題解決方案

4.1 SSH 連接失敗

# 測試SSH連接
ssh -T git@github.com  # GitHub示例
ssh -T git@gitlab.com  # GitLab示例# 若提示Permission denied，檢查：
# 1. 公鑰是否正確添加到Git服務
# 2. 防火墻是否開放SSH端口（默認22）

4.2 分支操作錯誤

# 查看所有分支（本地+遠程）
git branch -a
# 切換回主分支
git checkout main
# 刪除本地分支
git branch -d new-feature
# 刪除遠程分支
git push origin --delete new-feature

4.3 提交歷史修改

# 修改最近一次提交信息
git commit --amend -m "修正后的提交信息"
# 撤銷暫存
git reset HEAD filename
# 丟棄工作區修改
git checkout -- filename

• 通過以上步驟，你可以高效地使用 Git 進行版本控制，并實現 VSCode 與服務器的免密連接。建議定期同步代碼，保持分支整潔，遵循團隊統一的提交規范。