Cách khắc phục lỗi 'Terminal Process Terminated' trên VS Code

Vấn đề: Terminal không khởi động được

Chuyện này xảy ra với cả những người dày dạn kinh nghiệm nhất. Bạn đang dở dang dự án, nhấn `Ctrl + `` để chạy server, và... không có gì cả. Thay vì con trỏ nhấp nháy, bảng terminal chỉ lóe lên rồi tắt ngóm. Bạn nhận được một thông báo đầy khó chịu:

The terminal process terminated with exit code: [X]

Mã thoát (exit code) [X] chính là chìa khóa để giải quyết vấn đề. Bạn có thể thấy mã 1 đơn giản (lỗi chung), 127 (không tìm thấy lệnh), hoặc một chuỗi ký tự khó hiểu như 3221225477. Mã cuối cùng này đặc biệt phổ biến trên Windows—đó là lỗi 'Status Access Violation', thường có nghĩa là xung đột quyền truy cập hoặc xung đột bộ nhớ. Dù là con số nào, quy trình làm việc của bạn sẽ bị đình trệ cho đến khi lỗi được khắc phục.

Phân tích: Tại sao Terminal bị lỗi?

Thực tế VS Code không trực tiếp chạy các lệnh của bạn. Nó đóng vai trò như một cửa sổ, hay một "lớp vỏ" (wrapper), cho các shell bên ngoài như PowerShell, CMD, hoặc Zsh. Khi bạn mở terminal, VS Code sẽ cố gắng khởi chạy một trong những chương trình này ở chế độ nền. Nếu shell đó gặp trục trặc khi khởi động, nó sẽ đóng ngay lập tức. Sau đó, VS Code báo cáo rằng tiến trình đã bị "chấm dứt" (terminated).

Điều này thường xảy ra vì một vài lý do cụ thể sau:

• Đường dẫn bị hỏng: Bạn đã xóa hoặc di chuyển tệp .exe hoặc tệp thực thi của shell, nhưng VS Code vẫn đang tìm kiếm nó ở vị trí cũ.
• Chặn quyền truy cập: Phần mềm diệt virus hoặc 'Compatibility Mode' (Chế độ tương thích) của Windows đang ngăn cản shell lồng vào bên trong một ứng dụng khác.
• Cài đặt cũ: Bạn đã cập nhật VS Code, nhưng tệp settings.json vẫn sử dụng logic cấu hình lỗi thời từ ba năm trước.
• Biến môi trường quá tải: Biến PATH của hệ thống vượt quá giới hạn 2.048 ký tự, khiến shell bị nghẽn trong quá trình khởi tạo.

Cách khắc phục nhanh: Đặt lại Profile mặc định

Hãy bắt đầu với giải pháp đơn giản nhất. Có thể VS Code đang cố gắng khởi chạy một shell không còn tương thích với thiết lập hiện tại của bạn. Việc chuyển sang một profile khác thường sẽ xóa tan sự cố này.

• Mở Command Palette bằng tổ hợp phím Ctrl + Shift + P (hoặc Cmd + Shift + P trên Mac).
• Tìm kiếm "Terminal: Select Default Profile".
• Chuyển đổi profile mặc định. Nếu bạn đang dùng PowerShell, hãy thử Command Prompt hoặc Git Bash.
• Đóng mọi terminal đang treo và mở một cái mới.

Nếu shell mới vẫn hoạt động, bạn sẽ biết được vấn đề nằm ở cấu hình riêng của shell ban đầu.

Cách khắc phục triệt để 1: Dọn dẹp settings.json

Các cài đặt cũ là nguyên nhân phổ biến nhất. Các phiên bản VS Code trước đây sử dụng terminal.integrated.shell.windows, nhưng hiện tại nó đã bị loại bỏ. Nếu những dòng cũ này tồn tại trong cấu hình, chúng sẽ xung đột với hệ thống profile hiện đại.

• Mở Command Palette và tìm kiếm "Preferences: Open User Settings (JSON)".
• Tìm bất kỳ dòng nào có chứa từ khóa shell.
• Xóa những dòng cũ đó và thay thế bằng cấu hình hiện đại. Nó sẽ trông như thế này:

"terminal.integrated.profiles.windows": {
    "PowerShell": {
        "source": "PowerShell",
        "icon": "terminal-powershell"
    }
},
"terminal.integrated.defaultProfile.windows": "PowerShell"

Cách khắc phục triệt để 2: Sửa lỗi tương thích Windows (Mã thoát 3221225477)

Nếu bạn thấy mã thoát dài 3221225477, có khả năng Windows đang chặn tiến trình. Điều này thường xảy ra nếu trước đó bạn đã thiết lập VS Code chạy dưới quyền Administrator hoặc trong Chế độ tương thích (Compatibility Mode) cho một phiên bản Windows cũ hơn.

• Tìm shortcut của VS Code trên màn hình desktop hoặc tại thư mục C:\Users\[You]\AppData\Local\Programs\Microsoft VS Code.
• Chuột phải vào tệp Code.exe và chọn Properties.
• Chuyển đến tab Compatibility.
• Bỏ chọn "Run this program in compatibility mode."
• Bỏ chọn "Run this program as an administrator."
• Nhấp Apply, khởi động lại máy tính và thử mở lại terminal.

Cách khắc phục triệt để 3: Kiểm tra bên ngoài trình soạn thảo

Đôi khi nguyên nhân nằm ở tệp cấu hình cá nhân của shell, chẳng hạn như .zshrc, .bash_profile, hoặc $PROFILE của PowerShell. Nếu có lỗi cú pháp trong các script này, shell sẽ bị lỗi trước cả khi hiển thị dấu nhắc lệnh.

Để kiểm tra, hãy mở terminal gốc của máy tính (PowerShell độc lập hoặc Terminal.app). Nếu nó cũng bị lỗi ở đó, thì vấn đề không phải do VS Code. Bạn sẽ cần chỉnh sửa script profile của mình—thường nằm trong thư mục người dùng (home directory)—và sửa lệnh hoặc đường dẫn bị hỏng.

Xác minh: Lỗi đã thực sự được khắc phục chưa?

Đừng vội cho rằng nó đã hoạt động chỉ vì nó mở được một lần. Hãy làm theo các bước sau để đảm bảo sự ổn định hoàn toàn:

• Nhấp vào biểu tượng thùng rác trong bảng terminal để xóa tất cả các phiên làm việc.
• Khởi động lại VS Code.
• Run a command that uses some memory, like npm install or ls -R.
• Nếu terminal vẫn hoạt động sau các thao tác này, bạn đã thành công.

Vẫn thấy lỗi? Hãy kiểm tra nhật ký (logs) của phần mềm diệt virus. Các chương trình như Bitdefender hoặc Sophos đôi khi gắn cờ conpty.exe (pseudo-console của Windows) là đáng ngờ. Thêm VS Code vào danh sách 'Exclusions' (Loại trừ) thường là bước cuối cùng để có một môi trường làm việc ổn định.