Mô tả lỗi
Bạn thử khởi động một bản phân phối Linux từ Microsoft Store, hoặc gõ wsl trong PowerShell và nhận được thông báo sau:
The Windows Subsystem for Linux optional component is not enabled. Please enable it and try again.
See https://aka.ms/wslinstall for details.
WSL là một tính năng tùy chọn của Windows — bị tắt theo mặc định. Không có bản phân phối nào chạy được, và lệnh wsl sẽ không làm gì cả cho đến khi bạn bật tính năng này ở cấp hệ điều hành.
Ba cách để kích hoạt WSL
Chọn cách phù hợp với phiên bản Windows và phiên bản WSL bạn cần. WSL 2 là chuẩn hiện tại — nhanh hơn, tương thích tốt hơn, và được Microsoft khuyến nghị cho các cài đặt mới.
Cách 1: Cài đặt bằng một lệnh (Khuyến nghị cho WSL 2)
Windows 10 phiên bản 2004 (Build 19041) trở lên — bao gồm toàn bộ Windows 11 — hỗ trợ một lệnh duy nhất thực hiện tất cả mọi thứ:
wsl --install
Mở PowerShell với quyền Administrator và chạy lệnh đó. Phía sau, lệnh này sẽ:
- Kích hoạt tính năng tùy chọn WSL
- Kích hoạt Virtual Machine Platform
- Tải và cài đặt nhân Linux WSL 2
- Cài đặt Ubuntu làm bản phân phối mặc định
Khi hoàn tất, khởi động lại máy tính. WSL sẽ không hoạt động cho đến sau khi khởi động lại — không có ngoại lệ.
Không muốn dùng Ubuntu? Chỉ định bản phân phối khác:
wsl --install -d Debian
wsl --install -d kali-linux
wsl --install -d openSUSE-42
Để xem danh sách đầy đủ các bản phân phối có sẵn:
wsl --list --online
Cách 2: Kích hoạt tính năng thủ công (Windows 10 cũ hơn hoặc WSL 1)
Đang dùng build cũ hơn 19041? Hoặc cụ thể cần WSL 1? Thực hiện thủ công.
Bước 1 — Kích hoạt WSL:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Bước 2 — Kích hoạt Virtual Machine Platform (bắt buộc cho WSL 2):
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Bước 3 — Khởi động lại máy tính.
**Bước 4 — Cài đặt bản cập nhật nhân WSL 2:**Người dùng Windows 10 cần thêm bước này — tải gói cập nhật nhân từ trang chính thức của Microsoft và chạy nó. Windows 11 đã tích hợp sẵn nhân nên bỏ qua bước này.
Bước 5 — Đặt WSL 2 làm phiên bản mặc định:
wsl --set-default-version 2
Bước 6 — Cài đặt một bản phân phối từ Microsoft Store (tìm Ubuntu, Debian, v.v.) hoặc qua dòng lệnh:
wsl --install -d Ubuntu
Cách 3: Giao diện đồ họa Windows Features
Thích nhấp chuột hơn? Cách này cũng ổn.
- Nhấn
Win + R, gõoptionalfeatures, nhấn Enter - Cuộn xuống và tích vào Windows Subsystem for Linux
- Cũng tích vào Virtual Machine Platform nếu bạn muốn dùng WSL 2
- Nhấn OK và khởi động lại khi được yêu cầu
Kiểm tra kết quả
Đã khởi động lại xong? Mở PowerShell và kiểm tra trạng thái:
wsl --status
Kết quả bình thường trông như sau:
Default Version: 2
The Windows Subsystem for Linux kernel can be manually updated with 'wsl --update'.
Kiểm tra các bản phân phối đã cài đặt và phiên bản WSL đang chạy:
wsl --list --verbose
NAME STATE VERSION
* Ubuntu Stopped 2
Chạy wsl để khởi động. Xuất hiện dấu nhắc lệnh Linux? Bạn đã hoàn thành.
Các vấn đề thường gặp sau khi kích hoạt
"WslRegisterDistribution failed with error: 0x80370102"
Tính năng ảo hóa đang bị tắt trong BIOS/UEFI. Khởi động lại, vào cài đặt BIOS (thường nhấn Del hoặc F2 khi khởi động), và bật Intel VT-x hoặc AMD-V — đôi khi được liệt kê là SVM Mode. Đường dẫn menu chính xác tùy theo bo mạch chủ; kiểm tra hướng dẫn của bo mạch nếu không tìm thấy.
"Error: 0x1bc" khi đặt WSL 2 làm mặc định
Bản build Windows của bạn quá cũ để dùng WSL 2. Chạy Windows Update để đạt ít nhất phiên bản 2004 (Build 19041). Nếu chưa thể cập nhật ngay bây giờ, hãy dùng WSL 1 tạm thời:
wsl --set-default-version 1
Lệnh wsl --install không được nhận dạng
Bạn đang dùng Windows 10 build cũ hơn 19041. Bỏ qua Cách 1 hoàn toàn — dùng các bước dism.exe từ Cách 2 thay thế.
Tham chiếu nhanh
- Kiểm tra trạng thái WSL:
wsl --status - Liệt kê bản phân phối đã cài:
wsl --list --verbose - Cập nhật nhân WSL:
wsl --update - Tắt tất cả các phiên WSL:
wsl --shutdown - Gỡ cài đặt một bản phân phối:
wsl --unregister Ubuntu