github使用教學-2018世界杯比分-世界杯2018赛程表_今年世界杯

GitHub 使用教學手冊#📋 文件資訊#版本: 2.0更新日期: 2025年8月29日適用對象: 新進開發同仁、團隊協作開發者維護者: 專案開發團隊📚 目錄#Git/GitHub 基礎概念

1.1 什麼是 Git？1.2 什麼是 GitHub？1.3 為何要使用？1.4 版本控制的重要性1.5 團隊開發的挑戰1.6 Git 的解決方案1.7 GitHub 的附加價值環境設定

2.1 安裝 Git2.2 設定個人資訊2.3 GitHub 帳號設定2.4 Personal Access Token 設定（替代方案）2.5 Git 效能優化設定基本操作流程

3.1 Clone 專案3.2 建立 Feature Branch3.3 Commit Message 撰寫規範3.4 Push 到 Remote3.5 建立 Pull Request (PR)3.6 Code Review 流程3.7 Merge 規範Git 進階操作

4.1 Interactive Rebase4.2 Cherry-pick 操作4.3 Git Bisect 除錯4.4 Stash 暫存操作4.5 Submodule 子模組管理4.6 Git Hooks 自動化4.7 大型檔案處理 (LFS)日常工作流程建議

5.1 每日工作開始前5.2 避免衝突的最佳實務5.3 分支管理策略5.4 工作流程檢查清單5.5 團隊協作最佳實務常見錯誤與解決方式

6.1 Merge Conflict（合併衝突）6.2 錯誤的 Commit6.3 誤刪檔案恢復6.4 Push 被拒絕6.5 忘記切換分支6.6 Git 狀態混亂6.7 效能問題排除6.8 網路連線問題專案專屬規範

7.1 分支命名規則7.2 Commit Message 標準7.3 Pull Request 規範7.4 Code Review 標準GitHub 進階功能與協作工具

8.1 Issue 管理8.2 Project 專案管理8.3 Wiki 文件系統8.4 Releases 版本發布8.5 Discussions 社群討論8.6 Security 安全功能8.7 GitHub CLI 進階應用8.8 GitHub Apps 與整合8.9 GitHub Copilot 整合CI/CD 持續整合與部署

9.1 CI/CD 基礎概念9.2 工作流程設定9.3 進階 CI 配置9.4 持續部署 (CD)9.5 分支保護與自動化9.6 監控與通知9.7 Secrets 與環境變數管理9.8 最佳實務與注意事項安全最佳實務

10.1 認證與授權10.2 機密資訊管理10.3 程式碼安全掃描10.4 依賴套件安全10.5 分支保護規則10.6 審計與監控VS Code Git 整合深度應用

11.1 Source Control 面板詳解11.2 Git Graph 擴充功能11.3 GitLens 進階功能11.4 Merge Conflict 解決工具11.5 自動化工作流程設定附錄：常用指令清單

12.1 基本指令12.2 分支操作12.3 提交操作12.4 同步操作12.5 檢查與比較12.6 復原操作12.7 進階操作指令12.8 CI/CD 相關指令檢查清單

13.1 新進員工設定檢查清單13.2 日常開發檢查清單13.3 Code Review 檢查清單13.4 合併前檢查清單13.5 CI/CD 檢查清單13.6 GitHub 功能使用檢查清單13.7 緊急情況檢查清單13.8 安全檢查清單疑難排解與支援

14.1 常見問題 FAQ14.2 效能優化指南14.3 技術支援聯絡方式14.4 學習資源推薦1. Git/GitHub 基礎概念#1.1 什麼是 Git？#Git 是一個分散式版本控制系統，幫助開發團隊：

追蹤程式碼的變更歷史支援多人同時開發管理不同功能分支回復到任何歷史版本1.2 什麼是 GitHub？#GitHub 是基於 Git 的雲端程式碼託管平台，提供：

遠端程式碼倉庫存儲團隊協作工具（Pull Request、Issue）程式碼審查功能專案管理工具1.3 為何要使用？#🔍 版本控制的好處#追溯性: 知道誰在什麼時候修改了什麼備份性: 程式碼安全存放在雲端協作性: 多人可同時開發不衝突實驗性: 可建立分支測試新功能💼 團隊協作優勢#統一的程式碼審查流程清楚的變更歷史記錄自動化測試整合專案進度可視化1.4 版本控制的重要性#版本控制系統是現代軟體開發不可或缺的工具：

歷史追蹤: 完整記錄每次變更，可追溯任何時間點的程式碼狀態協同合作: 多人可同時在不同功能上開發，避免互相覆蓋分支管理: 可建立獨立分支進行實驗性開發，不影響主要程式碼錯誤復原: 當發現問題時，可快速回復到穩定版本1.5 團隊開發的挑戰#沒有版本控制時，團隊開發會遇到許多問題：

💥 程式碼衝突: 多人同時修改同一檔案，容易互相覆蓋� 版本混亂: 資料夾堆滿專案_v1, 專案_final, 專案_final_真的最終版❓ 追蹤困難: 不知道誰在什麼時候改了什麼，為什麼要改🐛 問題定位: 當發現 bug 時，難以確定是哪次修改造成的1.6 Git 的解決方案#Git 透過以下機制解決團隊開發挑戰：

分散式架構#每個開發者都有完整的程式碼庫副本不依賴中央伺服器即可進行版本控制離線也能提交變更和查看歷史分支策略#輕量級分支，建立和切換快速支援複雜的分支合併策略可並行開發多個功能變更追蹤#每次提交都有唯一識別碼記錄誰、何時、為何做了變更可輕鬆比較不同版本的差異1.7 GitHub 的附加價值#GitHub 在 Git 基礎上提供了豐富的協作功能：

協作工具#Pull Request: 程式碼審查和討論平台Issues: 問題追蹤和任務管理Projects: 看板式專案管理Wiki: 協作文件撰寫自動化功能#GitHub Actions: CI/CD 工作流程Dependabot: 依賴套件自動更新CodeQL: 程式碼安全掃描社群生態#開源專案託管程式碼分享和學習開發者社群互動�📝 實務案例#情境：小明要修改登入功能

傳統方式：複製整個專案資料夾 → 容易混亂

Git 方式：建立 feature/login-improvement 分支 → 清楚管理2. 環境設定#2.1 安裝 Git#Windows 系統#下載 Git：https://git-scm.com/download/win執行安裝檔，建議選項：✅ Git Bash Here✅ Git GUI Here✅ Associate .git* configuration files完成後開啟 PowerShell 驗證：git --versionmacOS 系統## 使用 Homebrew

brew install git

# 或使用 Xcode Command Line Tools

xcode-select --install2.2 設定個人資訊#### 設定使用者名稱（顯示在 commit 中）

git config --global user.name "您的姓名"

### 設定電子郵件（建議使用公司信箱）

git config --global user.email "your.email@company.com"

### 驗證設定

git config --list2.3 GitHub 帳號設定#建立 GitHub 帳號#前往 https://github.com點選 “Sign up” 註冊建議使用公司統一的命名規則SSH 金鑰設定（推薦）#### 1. 產生 SSH 金鑰

ssh-keygen -t ed25519 -C "your.email@company.com"

### 2. 啟動 SSH agent

eval "$(ssh-agent -s)"

### 3. 新增金鑰到 agent

ssh-add ~/.ssh/id_ed25519

### 4. 複製公鑰內容

cat ~/.ssh/id_ed25519.pub在 GitHub 新增 SSH 金鑰#登入 GitHub → Settings → SSH and GPG keys點選 “New SSH key”貼上公鑰內容並儲存測試連線：ssh -T git@github.com2.4 Personal Access Token 設定（替代方案）#如果無法使用 SSH，可使用 Token：

GitHub → Settings → Developer settings → Personal access tokens點選 “Generate new token”設定權限範圍（建議勾選 repo、workflow）複製 token（⚠️ 只會顯示一次）📝 注意事項#SSH 金鑰較安全且方便，建議優先使用Token 請妥善保存，不要提交到程式碼中定期更新 Git 版本以確保安全性2.5 Git 效能優化設定#基本效能設定#### 啟用平行處理

git config --global pack.threads 0

git config --global index.threads 0

### 提升 push/fetch 效能

git config --global pack.packSizeLimit 2g

git config --global pack.windowMemory 256m

### 啟用檔案系統監控（Windows）

git config --global core.fsmonitor true

git config --global core.untrackedcache true大型專案優化#### 設定 partial clone（僅克隆需要的部分）

git clone --filter=blob:none

### 設定淺層克隆（減少歷史記錄）

git clone --depth 1

### 僅下載指定分支

git clone --single-branch --branch 網路連線優化#### 增加緩衝區大小

git config --global http.postBuffer 524288000

### 設定連線超時

git config --global http.lowSpeedLimit 1000

git config --global http.lowSpeedTime 300

### 啟用 HTTP/2

git config --global http.version HTTP/23. 基本操作流程#3.1 Clone 專案#第一次取得專案#### 使用 SSH（推薦）

git clone git@github.com:your-organization/project-name.git

### 使用 HTTPS

git clone

### 進入專案目錄

cd project-name設定遠端倉庫別名#### 查看目前遠端設定

git remote -v

### 新增上游倉庫（用於同步主分支）

git remote add upstream git@github.com:main-organization/project-name.git3.2 建立 Feature Branch#分支命名規範#我們專案採用以下命名規範：

### 功能開發

feature/功能名稱-簡短描述

feature/user-login-validation

feature/payment-integration

### 錯誤修復

bugfix/錯誤描述

bugfix/login-session-timeout

bugfix/payment-calculation-error

### 熱修復

hotfix/緊急修復描述

hotfix/security-vulnerability

### 文件更新

docs/文件類型

docs/api-documentation

docs/user-guide建立分支流程#### 1. 確保在主分支並取得最新版本

git checkout main

git pull origin main

### 2. 建立並切換到新分支

git checkout -b feature/user-profile-update

### 3. 確認目前分支

git branch3.3 Commit Message 撰寫規範#格式標準#我們採用 Conventional Commits 格式：

<類型>[可選範圍]: <描述>

[可選本文]

[可選註腳]類型定義#類型說明範例feat新功能feat: 新增使用者登入功能fix錯誤修復fix: 修復登入頁面驗證問題docs文件變更docs: 更新 API 文件style程式碼格式style: 調整縮排格式refactor重構refactor: 重構使用者服務邏輯test測試相關test: 新增登入功能測試chore雜項任務chore: 更新依賴套件版本撰寫範例#### ✅ 良好的 commit message

git commit -m "feat: 新增使用者密碼強度驗證功能

- 實作密碼複雜度檢查

- 新增密碼強度指示器

- 更新相關測試案例

Closes #123"

### ❌ 不良的 commit message

git commit -m "修改"

git commit -m "update code"

git commit -m "fix bug"3.4 Push 到 Remote#基本推送流程#### 1. 檢查工作目錄狀態

git status

### 2. 新增變更檔案

git add . # 新增所有變更

git add src/main/User.java # 新增特定檔案

### 3. 提交變更

git commit -m "feat: 新增使用者註冊功能"

### 4. 推送到遠端分支

git push origin feature/user-registration

### 5. 首次推送設定上游分支

git push -u origin feature/user-registration推送前檢查清單# 程式碼已通過本地測試 Commit message 符合規範沒有包含敏感資訊（密碼、API key）程式碼已經過 lint 檢查3.5 建立 Pull Request (PR)#PR 建立步驟#推送分支後，GitHub 會顯示建立 PR 的提示填寫 PR 資訊：## 📋 變更摘要

簡述這個 PR 的目的和主要變更

## 🔧 變更內容

- [ ] 新增使用者註冊 API

- [ ] 實作 email 驗證功能

- [ ] 新增相關單元測試

- [ ] 更新 API 文件

## 🧪 測試

- [ ] 單元測試已通過

- [ ] 整合測試已通過

- [ ] 手動測試已完成

## 📸 截圖/影片

（如果是 UI 變更，請附上截圖）

## 🔗 相關 Issue

Closes #123

Related to #456PR 標題規範#[類型] 簡短描述 (#Issue編號)

範例：

[Feature] 新增使用者註冊功能 (#123)

[Bugfix] 修復登入驗證錯誤 (#456)

[Docs] 更新 API 使用說明 (#789)3.6 Code Review 流程#提交者責任#自我檢查：

程式碼符合專案規範測試覆蓋率充足文件已更新指派審查者：

至少指派 2 位審查者包含資深開發者或架構師審查者責任#檢查重點：

功能邏輯正確性程式碼品質與可讀性安全性考量效能影響回饋方式：

# ✅ 建設性回饋

建議將這個方法拆分為更小的函數，提高可讀性

# ❌ 非建設性回饋

這段程式碼不好3.7 Merge 規範#Merge 方式選擇#方式使用時機優點缺點Merge Commit功能分支合併保留分支歷史歷史較複雜Squash Merge小型功能歷史簡潔失去詳細歷史Rebase Merge單一提交線性歷史需要經驗專案預設設定#我們專案採用 Squash Merge：

保持主分支歷史簡潔每個功能一個提交便於回溯和 cherry-pick📝 完整開發流程範例#完整開發流程範例：

1. 接到任務：開發使用者頭像上傳功能

2. 建立分支：git checkout -b feature/user-avatar-upload

3. 開發程式碼：實作上傳邏輯、API、測試

4. 提交變更：git commit -m "feat: 新增使用者頭像上傳功能"

5. 推送分支：git push origin feature/user-avatar-upload

6. 建立 PR：填寫完整的 PR 描述

7. 程式碼審查：修正審查者建議

8. 合併到主分支：使用 Squash Merge

9. 刪除分支：清理遠端和本地分支4. Git 進階操作#4.1 Interactive Rebase#什麼是 Interactive Rebase？#Interactive Rebase 是一個強大的 Git 功能，允許你重新整理 commit 歷史。

### 重新整理最近 3 個 commit

git rebase -i HEAD~3

### 重新整理到指定 commit

git rebase -i 常用操作#pick - 保留 commit

reword - 修改 commit message

edit - 修改 commit 內容

squash - 合併到前一個 commit

fixup - 合併到前一個 commit（不保留 message）

drop - 刪除 commit實務範例#### 情境：合併多個小 commit 成一個功能 commit

git rebase -i HEAD~4

### 編輯器會開啟，修改為：

### pick 1234567 feat: 新增登入功能框架

### squash 2345678 feat: 加入密碼驗證

### squash 3456789 feat: 加入錯誤處理

### squash 4567890 feat: 新增單元測試4.2 Cherry-pick 操作#基本概念#Cherry-pick 可以選擇性地將某個 commit 應用到當前分支。

### 將特定 commit 應用到當前分支

git cherry-pick

### 應用多個 commit

git cherry-pick

### 應用一個範圍的 commit

git cherry-pick ..實務應用場景#### 場景1：緊急修復需要應用到多個分支

git checkout main

git cherry-pick

git checkout develop

git cherry-pick

### 場景2：選擇性合併功能

git checkout feature-branch

git cherry-pick 4.3 Git Bisect 除錯#自動化問題定位#Git Bisect 使用二分搜尋法快速定位引入問題的 commit。

### 開始 bisect

git bisect start

### 標記當前版本為有問題的版本

git bisect bad

### 標記某個已知正常的版本

git bisect good

### Git 會自動切換到中間的 commit

### 測試後標記結果

git bisect good # 或 git bisect bad

### 重複直到找到問題 commit

### 結束 bisect

git bisect reset自動化測試腳本#### 使用腳本自動化 bisect

git bisect start HEAD

git bisect run ./test-script.sh

### test-script.sh 範例

#!/bin/bash

make test

if [ $? -eq 0 ]; then

exit 0 # 測試通過

else

exit 1 # 測試失敗

fi4.4 Stash 暫存操作#基本 Stash 操作#### 暫存當前變更

git stash

### 暫存包含新檔案

git stash -u

### 暫存並添加訊息

git stash push -m "暫存登入功能開發中的變更"

### 查看 stash 列表

git stash list

### 應用最近的 stash

git stash pop

### 應用特定的 stash

git stash apply stash@{1}

### 刪除 stash

git stash drop stash@{0}進階 Stash 技巧#### 僅 stash 特定檔案

git stash push -m "僅暫存設定檔" config.js

### 建立新分支並應用 stash

git stash branch new-feature-branch stash@{0}

### 查看 stash 的差異

git stash show -p stash@{0}4.5 Submodule 子模組管理#新增子模組#### 添加子模組

git submodule add

### 例如

git submodule add lib/library使用子模組#### Clone 包含子模組的專案

git clone --recursive

### 或先 clone 再初始化子模組

git clone

git submodule init

git submodule update

### 更新子模組

git submodule update --remote

### 更新特定子模組

git submodule update --remote lib/library子模組最佳實務#### 總是記錄子模組的具體版本

cd lib/library

git checkout

cd ../..

git add lib/library

git commit -m "更新library到v1.2.3"

### 移除子模組

git submodule deinit lib/library

git rm lib/library

rm -rf .git/modules/lib/library4.6 Git Hooks 自動化#Pre-commit Hook##!/bin/sh

### .git/hooks/pre-commit

### 檢查程式碼格式

if ! npm run lint; then

echo "代碼格式檢查失敗，請修正後再commit"

exit 1

### 執行測試

if ! npm test; then

echo "測試失敗，請修正後再commit"

exit 1

echo "Pre-commit 檢查通過"Pre-push Hook##!/bin/sh

### .git/hooks/pre-push

### 檢查分支命名規範

branch=$(git rev-parse --abbrev-ref HEAD)

valid_pattern="^(feature|bugfix|hotfix)\/[a-z0-9-]+$"

if [[ ! $branch =~ $valid_pattern ]]; then

echo "分支名稱不符合規範: $branch"

echo "請使用格式: feature/feature-name"

exit 1

echo "Pre-push 檢查通過"4.7 大型檔案處理 (LFS)#安裝和設定 Git LFS#### 安裝 Git LFS

git lfs install

### 追蹤特定類型的檔案

git lfs track "*.psd"

git lfs track "*.mp4"

git lfs track "*.zip"

### 查看追蹤的檔案類型

git lfs track

### 提交 .gitattributes

git add .gitattributes

git commit -m "設定 Git LFS 追蹤規則"LFS 日常操作#### 查看 LFS 檔案

git lfs ls-files

### 檢查 LFS 狀態

git lfs status

### 手動添加大檔案到 LFS

git lfs track "large-file.zip"

git add large-file.zip

git commit -m "新增大型檔案"

### Clone 時不下載 LFS 檔案

git clone --filter=blob:none

git lfs pull # 需要時再下載5. 日常工作流程建議#5.1 每日工作開始前#同步主分支#### 1. 切換到主分支

git checkout main

### 2. 拉取最新變更

git pull origin main

### 3. 如果有設定 upstream，也同步上游

git fetch upstream

git merge upstream/main更新功能分支#### 1. 切換到功能分支

git checkout feature/your-feature

### 2. 合併主分支最新變更

git merge main

### 或使用 rebase（保持線性歷史）

git rebase main5.2 避免衝突的最佳實務#頻繁同步#### 建議每天至少執行一次

git checkout main

git pull origin main

git checkout feature/your-feature

git merge main小批次提交#### ✅ 好的實務：小而頻繁的提交

git add src/user/UserService.java

git commit -m "feat: 新增使用者驗證方法"

git add src/user/UserController.java

git commit -m "feat: 新增使用者 API 端點"

### ❌ 避免：一次大量提交

git add .

git commit -m "完成所有功能"5.3 分支管理策略#分支生命週期#1. 建立分支 ←── 從最新的 main 分支建立

2. 開發階段 ←── 頻繁提交，定期同步 main

3. 完成開發 ←── 最終測試，準備 PR

4. Code Review ←── 修正建議，可能需要額外提交

5. 合併主分支 ←── Squash merge 到 main

6. 清理分支 ←── 刪除遠端和本地分支分支清理#### 查看所有分支

git branch -a

### 刪除已合併的本地分支

git branch -d feature/completed-feature

### 強制刪除本地分支

git branch -D feature/abandoned-feature

### 刪除遠端分支

git push origin --delete feature/completed-feature

### 清理已刪除的遠端分支參考

git fetch --prune5.4 工作流程檢查清單#開始新功能前# 已同步最新的 main 分支從 main 建立新的功能分支分支名稱符合命名規範已設定正確的上游分支開發過程中# 定期提交小批次變更 Commit message 符合規範定期同步 main 分支變更程式碼通過本地測試提交 PR 前# 所有測試通過程式碼符合風格指南已更新相關文件 PR 描述完整清楚5.5 團隊協作最佳實務#溝通規範#📢 **團隊溝通原則**

1. **透明化**: 所有變更都應在相關的 issue 或 PR 中討論

2. **文件化**: 重要決策應記錄在 Wiki 或討論區

3. **及時反應**: 24小時內回應 PR review 請求

4. **建設性回饋**: 提供具體、可行的改進建議程式碼品質維護#### 每日程式碼品質檢查

### 1. 執行靜態分析

npm run lint

sonar-scanner

### 2. 檢查測試覆蓋率

npm run test:coverage

### 3. 依賴套件安全掃描

npm audit分支生命週期管理#🔄 **分支管理流程**

1. **功能分支** (feature/*)

- 生命週期: 1-2 週

- 定期與 main 同步

- 完成後立即刪除

2. **修復分支** (bugfix/*)

- 生命週期: 3-5 天

- 緊急修復可直接從 main 分支

3. **發布分支** (release/*)

- 生命週期: 1-3 天

- 僅允許 bug 修復和文件更新團隊規模化策略#### 小型團隊 (2-5人)

workflow: "GitHub Flow"

review_required: 1

merge_strategy: "Squash and merge"

### 中型團隊 (6-15人)

workflow: "Git Flow"

review_required: 2

merge_strategy: "Create merge commit"

branch_protection: true

### 大型團隊 (15+人)

workflow: "GitHub Flow + Feature flags"

review_required: 2-3

merge_strategy: "Squash and merge"

automated_testing: true知識分享機制#📚 **團隊學習計畫**

- **Code Review 學習**

- 每週輪流擔任 review 導師

- 分享最佳實務和常見問題

- **技術分享會**

- 每月技術主題分享

- Git 進階技巧工作坊

- **文件維護**

- 每季更新開發指南

- 新人 onboarding 流程優化6. 常見錯誤與解決方式#6.1 Merge Conflict（合併衝突）#發生原因#當兩個分支修改了同一個檔案的同一行時，Git 無法自動合併解決步驟#### 1. 拉取最新變更時發生衝突

git pull origin main

### 輸出：Auto-merging failed; fix conflicts and then commit

### 2. 查看衝突檔案

git status

### 輸出：Unmerged paths: both modified: src/User.java

### 3. 編輯衝突檔案

### 檔案中會顯示：

### <<<<<<< HEAD

### 您的變更

### =======

### 其他人的變更

### >>>>>>> branch-name

### 4. 手動解決衝突（保留需要的程式碼）

### 刪除衝突標記，保留正確的程式碼

### 5. 標記衝突已解決

git add src/User.java

### 6. 完成合併

git commit -m "resolve: 解決 User.java 合併衝突"預防衝突的方法#### 方法1：使用 rebase 替代 merge

git checkout feature/your-feature

git rebase main

### 方法2：頻繁同步主分支

git checkout main

git pull origin main

git checkout feature/your-feature

git merge main

### 方法3：協調開發範圍

### 團隊內溝通避免同時修改相同檔案6.2 錯誤的 Commit#修改最後一次 commit message#### 如果還沒 push

git commit --amend -m "正確的 commit message"

### 如果已經 push（需要 force push，要小心）

git commit --amend -m "正確的 commit message"

git push --force-with-lease origin feature/your-branch取消最後一次 commit#### 保留變更，只取消 commit

git reset --soft HEAD~1

### 完全取消變更和 commit

git reset --hard HEAD~1

### 取消多次 commit

git reset --soft HEAD~3 # 取消最近3次從 commit 中移除檔案#### 從最後一次 commit 中移除檔案

git reset --soft HEAD~1

git reset HEAD path/to/unwanted/file

git commit -m "正確的 commit message"6.3 誤刪檔案恢復#恢復已刪除但未 commit 的檔案#### 查看被刪除的檔案

git status

### 恢復特定檔案

git checkout HEAD -- path/to/deleted/file

### 恢復所有被刪除的檔案

git checkout HEAD -- .恢復已 commit 的刪除#### 查找檔案被刪除的 commit

git log --oneline --follow -- path/to/deleted/file

### 從該 commit 的前一版本恢復檔案

git checkout ~1 -- path/to/deleted/file

### 提交恢復的檔案

git add path/to/deleted/file

git commit -m "restore: 恢復意外刪除的檔案"6.4 Push 被拒絕#原因與解決#### 常見錯誤訊息

! [rejected] main -> main (fetch first)

### 原因：遠端分支有新的變更

### 解決方法：

git pull origin main

git push origin main

### 如果有衝突，先解決衝突再 pushForce Push 的正確使用#### ❌ 危險：可能覆蓋他人變更

git push --force origin main

### ✅ 安全：只在沒有他人變更時強制推送

git push --force-with-lease origin feature/your-branch6.5 忘記切換分支#在錯誤分支上開發#### 情況：在 main 分支上做了變更，但還沒 commit

### 解決：移動變更到正確分支

### 1. 暫存目前變更

git stash

### 2. 建立或切換到正確分支

git checkout -b feature/correct-branch

### 3. 恢復變更

git stash pop在錯誤分支上 commit#### 情況：已經在 main 分支上 commit

### 解決：移動 commit 到正確分支

### 1. 建立新分支（包含錯誤的 commit）

git branch feature/correct-branch

### 2. 重置 main 分支

git reset --hard HEAD~1

### 3. 切換到正確分支

git checkout feature/correct-branch6.6 Git 狀態混亂#重置到乾淨狀態#### 查看目前狀態

git status

### 取消所有未暫存的變更

git checkout -- .

### 移除未追蹤的檔案

git clean -fd

### 取消已暫存的變更

git reset HEAD

### 完全重置到最後一次 commit

git reset --hard HEAD📝 緊急求救指令#### 當一切都亂了，想回到安全狀態

git reflog # 查看所有操作歷史

git reset --hard HEAD@{n} # 回到特定操作前的狀態

### 備份目前狀態再進行危險操作

git branch backup-$(date +%Y%m%d-%H%M%S)

### 查看誰修改了什麼

git blame path/to/file # 查看每行的修改者

git log -p path/to/file # 查看檔案的修改歷史6.7 效能問題排除#Git 操作緩慢#### 診斷 Git 效能問題

git count-objects -v # 檢查物件數量

git gc --aggressive # 強制垃圾收集

git repack -a -d # 重新包裝物件大型儲存庫優化#### 檢查大型檔案

git rev-list --objects --all | \

git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \

awk '/^blob/ {print substr($0,6)}' | \

sort --numeric-sort --key=2 | \

tail -20

### 清理無用的參考

git remote prune origin

git gc --prune=now

### 使用 partial clone 減少下載大小

git clone --filter=blob:limit=100k 網路連線問題診斷#### 測試連線

ssh -T git@github.com

ping github.com

### 檢查 SSL 設定

git config --global http.sslVerify false # 臨時解決方案

git config --global http.sslBackend schannel # Windows

### 使用 HTTP 替代 SSH（臨時）

git remote set-url origin 6.8 網路連線問題#SSH 連線問題#### 檢查 SSH 金鑰

ssh-add -l

ssh -T git@github.com

### 重新生成 SSH 金鑰

ssh-keygen -t ed25519 -C "your.email@example.com"

ssh-add ~/.ssh/id_ed25519

### SSH 設定檔 (~/.ssh/config)

Host github.com

HostName github.com

User git

IdentityFile ~/.ssh/id_ed25519

IdentitiesOnly yes代理伺服器設定#### HTTP 代理設定

git config --global http.proxy

git config --global https.proxy

### SOCKS 代理設定

git config --global http.proxy socks5://localhost:1080

### 取消代理設定

git config --global --unset http.proxy

git config --global --unset https.proxy防火牆問題解決#### 使用 HTTPS 替代 SSH

git config --global url." git@github.com:

### 測試不同埠號

ssh -T -p 443 git@ssh.github.com

### SSH 設定使用 443 埠

Host github.com

Hostname ssh.github.com

Port 443

User git7. 專案專屬規範#7.1 分支命名規則#強制規範#格式：<類型>/<簡短描述>-<票號>

範例：

✅ feature/user-authentication-123

✅ bugfix/login-timeout-456

✅ hotfix/security-patch-789

✅ docs/api-documentation-012

❌ my-feature

❌ fix

❌ temp-branch

❌ test123分支類型定義#類型用途生命週期合併目標feature/*新功能開發中長期mainbugfix/*錯誤修復短期mainhotfix/*緊急修復即時main + releasedocs/*文件更新短期mainrefactor/*程式碼重構中期maintest/*測試相關短期main7.2 Commit Message 標準#強制格式#():