Lỗi Gặp Phải
Bạn mở VS Code và một thanh cảnh báo màu vàng xuất hiện ở trên cùng:
Your Code installation appears to be corrupt. Please reinstall.
VS Code vẫn hoạt động được, nhưng cảnh báo này cứ xuất hiện mỗi lần khởi động. Ở một số phiên bản, nó chặn hẳn các tính năng, hoặc liên tục nhắc nhở bạn mỗi khi khởi động cho đến khi bạn xử lý xong.
Nguyên Nhân
VS Code có sẵn một bộ kiểm tra tính toàn vẹn. Khi khởi động, nó tính toán checksum của các file cốt lõi và so sánh với file manifest product.json. Chỉ cần một byte sai ở bất kỳ đâu — cảnh báo sẽ xuất hiện ngay.
Các nguyên nhân phổ biến nhất:
- Extension vá trực tiếp vào nội bộ VS Code — đặc biệt là các extension tùy chỉnh thanh tiêu đề hoặc theme có inject CSS vào các file HTML/JS của chính VS Code.
- Chỉnh sửa thủ công các file ứng dụng của VS Code (ví dụ: sửa file
workbench.htmlđể xóa cảnh báo "unsupported" — một cách giải quyết phổ biến nhưng lại chính nó gây ra cảnh báo này). - Phần mềm diệt virus hoặc bảo mật chỉnh sửa hoặc cách ly các file bên trong thư mục cài đặt VS Code.
- Cập nhật không hoàn chỉnh — một bản tự động cập nhật bị gián đoạn giữa chừng.
- Lỗi hệ thống file — hiếm gặp, nhưng có thể xảy ra trên các hệ thống không ổn định.
Cách Sửa 1: Tắt Kiểm Tra Tính Toàn Vẹn (Nhanh Nhất)
Lỗi do extension hoặc do bạn chỉnh sửa có chủ đích? Bạn có thể tắt cảnh báo mà không cần cài lại.
Cài extension Fix VSCode Checksums:
- Mở panel Extensions (
Ctrl+Shift+X/Cmd+Shift+X). - Tìm kiếm Fix VSCode Checksums (của lehni).
- Cài extension, sau đó mở Command Palette (
Ctrl+Shift+P) và chạy:Fix Checksums: Apply - Khởi động lại VS Code khi được nhắc.
Extension này tính lại checksum từ các file hiện tại của bạn và vá lại file manifest. Bộ kiểm tra của VS Code chạy lại, tìm thấy kết quả khớp, và cảnh báo biến mất.
Cách Sửa 2: Cài Lại VS Code (Sạch Sẽ, Khuyến Nghị)
Cách 1 không hiệu quả, hoặc bạn đang gặp một bản cập nhật lỗi? Cài lại sạch là con đường đáng tin cậy nhất. Tin vui là: cài đặt, extension và phím tắt nằm trong thư mục riêng — chúng sẽ không bị ảnh hưởng khi cài lại.
Windows
- Gỡ cài đặt VS Code qua Cài đặt → Ứng dụng.
- Xóa các thư mục còn sót lại nếu chúng tồn tại:
%LOCALAPPDATA%\Programs\Microsoft VS Code %APPDATA%\Code ← ĐỪNG xóa cái này — chứa cài đặt của bạn
- Tải bản cài đặt mới nhất từ [code.visualstudio.com](https://code.visualstudio.com) và cài đặt.
### macOS
- Kéo VS Code từ `/Applications` vào Thùng rác.
- Tải file `.zip` từ trang VS Code, giải nén và kéo lại vào `/Applications`.
- Cài đặt của bạn trong `~/Library/Application Support/Code` vẫn được giữ nguyên.
### Linux (apt)
sudo apt remove code sudo apt install code
Hoặc với Snap:
sudo snap remove code sudo snap install code --classic
## Cách Sửa 3: Sửa Chữa Mà Không Cần Cài Lại (Chỉ Windows)
Người dùng Windows có một lối tắt. Bộ cài đặt của VS Code có chế độ sửa chữa, sao chép lại các file bị thay đổi hoặc thiếu mà không xóa mọi thứ:
- Vào **Cài đặt → Ứng dụng → Visual Studio Code → Sửa đổi**.
- Chọn **Repair** trong trình hướng dẫn cài đặt.
- Xong — không cần cài lại toàn bộ.
## Cách Sửa 4: Kiểm Tra Can Thiệp Từ Phần Mềm Diệt Virus
Lỗi quay lại sau khi cài mới? Phần mềm diệt virus của bạn gần như chắc chắn là thủ phạm. Thêm thư mục cài đặt VS Code vào danh sách ngoại lệ:
- **Windows**: `%LOCALAPPDATA%\Programs\Microsoft VS Code`
- **macOS**: `/Applications/Visual Studio Code.app`
- **Linux**: `/usr/share/code` hoặc nơi bản phân phối của bạn cài đặt
## Xác Nhận Đã Sửa Xong
Khởi động lại VS Code hoàn toàn — đóng tất cả cửa sổ, không chỉ cửa sổ hiện tại. Nếu thanh màu vàng biến mất lần khởi động tiếp theo, bạn đã xong.
Muốn kiểm tra kỹ hơn? Xem log khởi động:
Help → Toggle Developer Tools → Console
Tìm kiếm `checksum` hoặc `corrupt`. Một bản cài đặt sạch sẽ không ghi lại bất cứ điều gì về cả hai từ khóa này.
## Phòng Ngừa
Ba thói quen giúp cảnh báo này không quay lại:
- **Cẩn thận với các extension ghi vào nội bộ VS Code.** Các extension như Custom CSS and JS Loader inject trực tiếp vào file ứng dụng của VS Code — chúng sẽ luôn kích hoạt kiểm tra tính toàn vẹn. Có thể đáng dùng với một số thiết lập, nhưng hãy biết rõ sự đánh đổi trước khi dùng.
- **Để quá trình cập nhật hoàn tất.** Đừng tắt VS Code khi nó đang cập nhật nền. Một lần ghi dở chừng là cách chắc chắn để rơi vào tình trạng cài đặt bị lỗi.
- **Xác minh bộ cài đặt trước khi chạy.** Kết nối chậm hoặc không ổn định? Một bản tải về không đầy đủ có thể tạo ra bản cài đặt bị lỗi âm thầm. Hãy so sánh mã hash SHA-256 của file `.exe` hoặc `.dmg` với mã hash trên trang phát hành VS Code. [Hash Generator tại ToolCraft](https://toolcraft.app/en/tools/developer/hash-generator) thực hiện điều này ngay trên trình duyệt — dán file vào, chọn SHA-256 và so sánh. Không có dữ liệu nào rời khỏi máy bạn.