Sửa lỗi: VS Code "Git Not Found" — Để Source Control hoạt động trở lại

Thanh bên trống trải đầy khó chịu

Bạn mở VS Code, nhấn Ctrl+Shift+G để kiểm tra các thay đổi, và... không có gì cả. Thay vì các tệp đã được stage, bạn nhận được một thông báo liên tục:

Git not found. Install it or configure it using the 'git.path' setting.

Điều này xảy ra khi trình soạn thảo mất dấu tệp thực thi Git. Cho dù bạn vừa xóa sạch ổ cứng, cập nhật VS Code hay vô tình chỉnh sửa các biến môi trường, việc khắc phục thường mất chưa đầy hai phút.

Bước 0: Chẩn đoán trong 5 giây

Trước tiên, hãy xem vấn đề là ở toàn hệ thống hay chỉ trong VS Code. Mở terminal của bạn (PowerShell, CMD hoặc Terminal.app) và nhập:

git --version

"Command not found": Git chưa có trên máy tính của bạn. Hãy chuyển sang Bước 1.
Git version 2.x.x: Git vẫn ổn. Chỉ là VS Code không biết nó nằm ở đâu. Hãy chuyển sang Bước 2 hoặc 3.

Bước 1: Cài đặt Git (Nếu thiếu)

Nếu kiểm tra terminal không có kết quả, bạn cần cài đặt Git. VS Code chỉ là giao diện; nó sẽ không tự cài đặt Git cho bạn.

Windows: Tải bộ cài đặt từ git-scm.com. Chọn "Git from the command line and also from 3rd-party software" trong trình hướng dẫn cài đặt.
macOS: Mở terminal và chạy xcode-select --install. Nếu bạn dùng Homebrew, brew install git thậm chí còn nhanh hơn.
Linux: Sử dụng trình quản lý gói của bạn. Trên Ubuntu, chạy sudo apt update && sudo apt install git.

Sau khi hoàn tất, đóng và mở lại VS Code. Nó sẽ quét môi trường khi khởi động, vì vậy việc khởi động lại thường xóa lỗi ngay lập tức.

Bước 2: Sửa lỗi System PATH trên Windows

Người dùng Windows thường thấy Git hoạt động trong terminal riêng biệt nhưng lại lỗi bên trong trình soạn thảo. Điều này thường có nghĩa là "danh sách tìm kiếm" của hệ thống đang thiếu thư mục Git.

Nhấn phím Windows và nhập "env". Chọn Edit the system environment variables.
Nhấp vào nút Environment Variables ở phía dưới.
Tìm Path trong phần "System variables" và nhấp vào Edit.
Đảm bảo hai dòng này tồn tại. Nếu không, nhấp vào New và thêm chúng:

C:\Program Files\Git\bin
- C:\Program Files\Git\cmd
Nhấp OK, lưu các thay đổi và khởi động lại máy tính nếu việc khởi động lại VS Code không có tác dụng.

Bước 3: Trỏ trực tiếp VS Code tới Git

Nếu bạn không muốn thay đổi cài đặt hệ thống—hoặc nếu bạn đang sử dụng phiên bản Git Portable—bạn có thể chỉ định đường dẫn cứng bên trong VS Code.

Tìm tệp thực thi của bạn

Trong terminal, hãy chạy lệnh để xác định đường dẫn tệp thực tế:

Windows: where git (Tìm dòng kết thúc bằng \bin\git.exe)
macOS/Linux: which git

Sao chép đường dẫn đó. Nó thường trông như C:\Program Files\Git\bin\git.exe hoặc /usr/bin/git.

Cập nhật cài đặt của bạn

Mở Settings trong VS Code (Ctrl + ,).
Tìm kiếm git.path và nhấp vào Edit in settings.json.
Thêm đường dẫn. Lưu ý cho Windows: Bạn phải sử dụng dấu gạch chéo ngược kép (\\) để tránh lỗi JSON.

// Cấu hình cho Windows
"git.path": "C:\\Program Files\\Git\\bin\\git.exe"

// Cấu hình cho macOS/Linux
"git.path": "/usr/local/bin/git"

Lưu tệp. Tab Source Control của bạn sẽ hoạt động ngay lập tức.

Khắc phục sự cố nâng cao

Rào cản từ WSL

Nếu bạn đang làm việc trong cửa sổ WSL (Windows Subsystem for Linux), VS Code sẽ bỏ qua bản cài đặt Git trên Windows của bạn. Nó yêu cầu Git phải được cài đặt bên trong bản phân phối Linux. Hãy chạy sudo apt install git trong terminal Ubuntu của bạn để đáp ứng yêu cầu của extension.

Bảo mật và Quyền hạn

Máy tính xách tay của công ty đôi khi chặn các "tiến trình con" (child processes). Nếu đường dẫn chính xác nhưng lỗi vẫn còn, hãy kiểm tra nhật ký phần mềm diệt virus. Đôi khi phần mềm bảo mật ngăn VS Code "khởi tạo" (spawning) tiến trình Git, khiến trình soạn thảo không thể thấy kho lưu trữ của bạn.