VS Code 已經裝好，但提交作業時顯示找不到 Git。
最快的處理方式是：先執行 git --version，確認 Mac 是否已有可用版本；普通課程優先使用 Xcode Command Line Tools，只有課程或工具明確要求較新版本時，才改用 Homebrew。最後完成身份設定與一次測試提交，才算真正安裝完成。
這篇文章適合第一次在 Mac 上接觸 Git、不知道 Command Line Tools 和 Homebrew 怎麼選的學生。
如果你使用遠端 Mac、學校電腦，或 VS Code 的原始碼管理面板找不到 Git，也可以照著同一條驗收流程處理。
最後更新於 2026 年 9 月 8 日；Git 版本與安裝路線核實自 Git 官方 macOS 安裝頁。
01 第一步：先確認 Mac 目前呼叫的是哪個 Git
不要一看到錯誤就重新安裝。電腦裡「已經有 Git」，和終端機目前「正在呼叫哪個 Git」是兩件事。
先開啟 macOS 的 Terminal。你可以在 Finder 的「應用程式」內找到它，也可以用 Spotlight 搜尋 Terminal；Apple 的 Terminal 官方使用指南也說明了基本開啟方式。
依序輸入：
git --version
command -v git
第一行查看 Git 版本，第二行查看實際執行檔位置。Git 官方文件對 git --version 的用途有明確說明，可參考 Git 版本指令文件。
你可能看到以下結果：
| 終端機結果 | 代表什麼 | 下一步 |
|---|---|---|
顯示 git version ...，並有檔案路徑 |
Git 已可被終端機找到 | 先對照課程要求，不要急著重裝 |
| 顯示需要安裝開發者工具的提示 | Mac 偵測到缺少 Command Line Tools | 進入下一節完成安裝 |
| 顯示找不到指令 | Git 未在目前 PATH 中，或尚未安裝 | 先使用 Command Line Tools 路線 |
截至上述更新日期，Git 官方 macOS 頁面列出的最新版本是 2.55.0，同頁也列出 Homebrew、MacPorts 與 Xcode Command Line Tools 等路線。但你實際安裝後得到的版本，仍要以自己的 git --version 輸出為準，不能只看教學標題判斷。
02 Mac 安裝 Git 2.55：先按課程要求選路線
「Mac 安裝 Git 2.55」不代表每個人都要手動追到完全相同的修訂版本。若老師只要求能初始化儲存庫、提交作業和配合 VS Code 使用，穩定完成工作比追逐版本號更重要。
| 安裝路線 | 適合情況 | 完成標誌 | 先停止的條件 |
|---|---|---|---|
| Xcode Command Line Tools | 一般 Git 課程、提交作業、VS Code 基本工作流 | git --version 能回傳版本 |
課程沒有指定較新 Git 時，不必再換路線 |
| Homebrew | 課程明確要求較新 Git，或你已在用套件管理工具 | 安裝後重新檢查版本與路徑 | 不熟悉套件管理、只是初學作業時，不要為了版本號硬裝 |
| 從原始碼編譯 | 特殊開發或維護需求 | 需自行處理編譯與更新 | 零基礎課程不建議採用 |
路線 A：使用 Xcode Command Line Tools
當終端機顯示安裝提示時，先接受系統提供的開發工具安裝。這條路線的優點是步驟少，適合只想把課程作業提交出去的初學者。
安裝完成後，不要把安裝視窗關閉就當成成功。重新開啟 Terminal，執行：
git --version
command -v git
若能顯示版本與路徑，再進入身份設定。若仍顯示找不到 Git，記下完整錯誤文字，不要修改受保護的系統目錄，也不要執行來源不明的安裝腳本。
路線 B：使用 Homebrew
只有在課程、工具或團隊規範明確需要較新 Git 時，才考慮 Homebrew。先查看 Git 官方 macOS 安裝路線，確認目前建議的來源，再依官方指示安裝。
安裝後，必須重新檢查：
git --version
command -v git
如果版本沒有如預期改變，常見原因不是「Git 沒裝好」，而是終端機仍沿用另一個路徑。這時先比較 command -v git 的結果與課程說明，不要同時安裝多條路線，否則你會更難判斷 VS Code 實際使用哪一個 Git。
| 檢查項目 | 可接受結果 | 不要做的事 |
|---|---|---|
| 版本 | 與課程最低要求相符 | 只因看到舊版本就刪除系統檔案 |
| 路徑 | 指向你預期的 Git 執行檔 | 直接修改受保護目錄 |
| 終端機 | 可正常輸入 Git 指令 | 只依賴安裝程式顯示「完成」 |
| VS Code | 原始碼管理面板能辨識儲存庫 | 把編輯器錯誤當成 Git 版本錯誤 |
03 第二步：設定提交身份與連線方式
Git 提交身份會寫入每次提交記錄。它不等於程式碼平台登入帳號，也不等於 SSH 私鑰或 HTTPS 存取權杖。
先設定名稱與電子郵件：
git config --global user.name "你的顯示名稱"
git config --global user.email "你選擇的電子郵件"
接著檢查：
git config --global --get user.name
git config --global --get user.email
你不一定要公開私人郵箱，也不必為了作業隨便填一個不存在的地址。較穩妥的做法，是依學校課程或程式碼平台的帳戶規範選擇可長期使用的地址。Pro Git 的首次 Git 設定說明可核對上述設定方式。
如果課程要求指定預設分支名稱，可以設定：
git config --global init.defaultBranch main
這只影響你之後初始化的新儲存庫，不會自動改寫已存在的專案。
連線認證則是另一件事。HTTPS 和 SSH 是不同的連線方式，不要把密碼、存取權杖或私鑰貼給同學，也不要把它們放進作業檔案。關於帳戶認證與個人存取權杖，請以程式碼平台官方認證說明及權杖管理文件為準。
04 第三步：用可刪除的測試資料完成首次提交
不要直接拿正式作業測試。先建立一個可以刪除的小資料夾，這樣即使輸入錯誤，也不會破壞課程專案。
mkdir git-test
cd git-test
git init
printf "# Git 測試\n" > README.md
git status
git add README.md
git commit -m "完成第一次測試提交"
git log --oneline -1
這段流程依序做了幾件事：
git init：把資料夾建立成 Git 儲存庫。git status：查看目前有哪些檔案尚未納入追蹤。git add：把檔案放進下一次提交的準備區。git commit：建立一個存檔點。git log：確認提交真的出現在歷史紀錄中。
Pro Git 的儲存庫基礎說明可用來核對初始化和提交的基本概念。若提交時顯示身份未設定，回到上一節檢查 user.name 和 user.email，不要把錯誤訊息當成 Git 安裝失敗。
05 第四步：讓 VS Code 識別同一個專案
在 VS Code 開啟剛才的 git-test 資料夾，不要只開啟單一的 README.md。接著在檔案中加入一行文字並儲存，查看左側原始碼管理面板是否顯示檔案變更。
VS Code 的原始碼管理功能會使用 Mac 上可取得的 Git。你可以參考 VS Code 原始碼管理總覽與快速入門流程。
驗收時確認：
- 終端機仍能執行
git --version。 - VS Code 顯示目前資料夾是 Git 儲存庫。
- 修改檔案後，原始碼管理面板出現變更。
- 你能查看差異，而不是只看到檔名。
- 重新提交後，終端機的
git log有新記錄。
若終端機正常、VS Code 卻找不到 Git，先查看 VS Code 的 Git 設定與輸出記錄，再參考官方 Git 排錯說明。不要立刻重裝全部工具，因為問題可能只是編輯器使用了不同的執行檔路徑。
06 遠端 Mac 或學校電腦上的專案，如何安全保存
遠端 Mac 的工作資料不能只留在租用中的硬碟或桌面。正式開始作業前，先確認專案已推送到課程允許的程式碼儲存庫，或另外下載一份包含原始碼與必要設定的備份。
| 使用環境 | 你要先確認的事 | 結束前的處理 |
|---|---|---|
| 本地 Mac | 專案位置、帳戶和備份位置 | 提交未完成變更，再備份專案 |
| 遠端 Mac | 連線帳戶、專案儲存位置和服務期限 | 匯出專案，確認可在另一台電腦開啟 |
| 學校受限電腦 | 是否允許安裝工具與登入帳戶 | 不繞過管理限制，改用獲授權的環境保存作業 |
遠端環境即將到期時，先在本地或另一個獲授權的環境複製專案，再檢查檔案是否完整。若只把程式碼留在遠端桌面，帳戶結束後可能無法取回。你可以先閱讀 CALMVPS 的遠端 Mac 使用入口，再按照自己的課程需求安排工作環境。
請勾選以下清單，四項都完成後才開始正式作業：
- [ ]
git --version能正常回傳版本。 - [ ] 已確認目前 Git 的實際路徑。
- [ ] 已設定並檢查提交名稱與電子郵件。
- [ ] 測試資料夾已完成一次提交。
- [ ] VS Code 能顯示檔案修改與差異。
- [ ] 正式專案有獲授權的備份位置。
- [ ] 遠端 Mac 到期前有明確的匯出安排。
如果你現在使用的 Windows 或學校電腦不能安裝課程工具，先不要把正式作業直接搬到陌生環境。可以在具備完整權限的遠端 Mac 上重做這套 Git 驗收：先用可刪除的小專案確認編輯、提交和備份，再移轉正式作業。相較之下，受限制的學校電腦可能沒有安裝權限，Windows 也未必能直接提供 macOS 專用工具；若你只需要短期完成課程或測試，透過 CALMVPS 的方案頁面查看可用選項，通常比為一次作業購買整台 Mac 更容易控制投入。若需要進一步安排環境，可再到遠端 Mac 申請頁確認流程。
當版本檢查、身份設定、測試提交、VS Code 識別和專案備份都通過後，Mac 安裝 Git 2.55 才算真正完成；不要只用版本號判斷環境是否能交作業。