Skip to content

WSL

Published Feb 25, 2025 by vuongdat67

OS Setup
WSL

Hướng dẫn cài đặt WSL2 (Windows Subsystem for Linux)¤

Yêu cầu hệ thống¤

  • Windows 10 version 2004+ (Build 19041+) hoặc Windows 11
  • Hỗ trợ virtualization (Intel VT-x/AMD-V)
  • RAM tối thiểu 4GB (khuyến nghị 8GB+)

Bước 1: Kích hoạt Windows Features¤

Mở PowerShell với quyền Administrator và chạy lần lượt 2 lệnh sau:

PowerShell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
PowerShell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Lưu ý quan trọng

KHÔNG restart ngay sau 2 lệnh trên. Thực hiện xong 2 lệnh rồi mới restart.

Bước 2: Cấu hình BIOS/UEFI¤

Vấn đề thường gặp - BSOD 0x13A

Nếu restart gặp Blue Screen với mã lỗi 0x13A (KERNEL_MODE_HEAP_CORRUPTION), nguyên nhân thường là:

  • Secure Boot chưa được bật
  • Virtualization chưa enable đúng cách
  • Conflict với VMware/VirtualBox phiên bản cũ

Các bước khắc phục:

  1. Restart và vào BIOS/UEFI (thường nhấn F2, F12, Delete khi khởi động)

  2. Tìm và enable các settings sau:

    Text Only
    ✅ Intel VT-x (hoặc AMD-V)
✅ Intel VT-d (hoặc AMD IOMMU) 
✅ Secure Boot
✅ Hyper-Threading (nếu có)

  3. Save & Exit BIOS

  4. Restart Windows bình thường

Bước 3: Cài đặt WSL2¤

Mở PowerShell với quyền Administrator:

PowerShell
# Set WSL2 làm version mặc định
wsl --set-default-version 2
PowerShell
# Xem danh sách distributions có sẵn
wsl --list --online
# Hoặc dùng lệnh ngắn gọn: wsl -l -o
PowerShell
# Cài đặt Ubuntu (khuyến nghị)
wsl --install -d Ubuntu-24.04

Lỗi HCS_E_CONNECTION_TIMEOUT (0x80370109)

Nếu gặp lỗi này khi cài đặt:

Nguyên nhân: VMware/VirtualBox đang chạy conflict với Hyper-V

Khắc phục:

PowerShell
# Tắt VMware services tạm thời
net stop "VMware Authorization Service"
net stop "VMware USB Arbitration Service"
taskkill /f /im vmware-tray.exe

# Restart WSL và thử lại
wsl --shutdown
wsl --install -d Ubuntu-24.04

Bước 4: Kiểm tra cài đặt¤

PowerShell
# Xem danh sách distributions đã cài
wsl --list --verbose
# Hoặc: wsl -l -v

Kết quả mong muốn:

Text Only
  NAME            STATE           VERSION
* Ubuntu-24.04    Running         2

Bước 5: Cập nhật WSL¤

PowerShell
# Update WSL kernel
wsl --update

Làm theo hướng dẫn nếu có yêu cầu restart.

Bước 6: Thiết lập Ubuntu lần đầu¤

  1. Tìm Ubuntu trong Start Menu và mở
  2. Chờ quá trình initialization hoàn tất
  3. Tạo username và password:

Gợi ý

  • Username: admin (dễ nhớ)
  • Password: chọn mật khẩu đơn giản để tránh quên
  • Lưu ý: Khi gõ password sẽ không hiển thị ký tự nào trên màn hình (bình thường)

Bước 7: Cài đặt công cụ phát triển¤

Trong terminal Ubuntu, chạy:

Bash
# Update package list
sudo apt update -y

# Cài đặt compiler và build tools
sudo apt install gcc binutils build-essential -y

Cấu hình VSCode với WSL¤

Cài đặt Extension¤

Trong VSCode, cài đặt extension WSL của Microsoft.

Cấu hình Terminal¤

Cách 1: Qua Settings UI - Ctrl + , → tìm "terminal" - Chọn "Terminal › Integrated › Default Profile: Windows" - Chọn Ubuntu (WSL)

Cách 2: Edit settings.json - Ctrl + Shift + P → "Preferences: Open User Settings (JSON)" - Thêm cấu hình:

JSON
{
    "terminal.integrated.defaultProfile.windows": "Ubuntu (WSL)",
    "terminal.integrated.profiles.windows": {
        "Ubuntu (WSL)": {
            "path": "C:\\Windows\\System32\\wsl.exe",
            "args": ["-d", "Ubuntu-24.04"],
            "icon": "terminal-ubuntu"
        }
    },
    "terminal.integrated.fontSize": 14,
    "terminal.integrated.fontFamily": "Consolas, 'Courier New', monospace"
}

Các lệnh WSL hữu ích¤

Quản lý Distributions¤

PowerShell
# Xem danh sách distros
wsl -l -v

# Xem distros có thể cài
wsl -l -o

# Xóa distro
wsl --unregister <DistroName>

# Set distro mặc định
wsl --set-default <DistroName>

Quản lý phiên bản¤

PowerShell
# Convert WSL1 sang WSL2
wsl --set-version <DistroName> 2

# Set version mặc định cho distro mới
wsl --set-default-version 2

# Check trạng thái WSL
wsl --status

Khởi động/Tắt¤

PowerShell
# Tắt tất cả WSL instances
wsl --shutdown

# Tắt distro cụ thể
wsl --terminate <DistroName>

# Khởi động distro cụ thể
wsl -d <DistroName>

Import/Export¤

PowerShell
# Backup distro
wsl --export Ubuntu-24.04 ubuntu-backup.tar

# Restore từ backup
wsl --import Ubuntu-New C:\WSL\Ubuntu-New ubuntu-backup.tar

Lệnh Linux cơ bản¤

Bash
# Hiển thị đường dẫn hiện tại
pwd

# List files/folders
ls -la

# Chuyển thư mục
cd /home/username    # Đường dẫn tuyệt đối
cd ~                 # Về home directory
cd ..                # Lên thư mục cha
cd -                 # Quay lại thư mục trước

# Tạo/xóa thư mục
mkdir folder_name
rmdir folder_name    # Xóa thư mục rỗng
rm -rf folder_name   # Xóa thư mục và nội dung

File Operations¤

Bash
# Copy/Move
cp file1 file2           # Copy file
cp -r folder1/ folder2/  # Copy thư mục
mv old_name new_name     # Đổi tên/di chuyển

# Xem nội dung file
cat filename        # Hiển thị toàn bộ
less filename       # Xem từng trang
head filename       # 10 dòng đầu
tail filename       # 10 dòng cuối
tail -f filename    # Theo dõi file realtime

System Information¤

Bash
# Thông tin hệ thống
uname -a            # Kernel info
lsb_release -a      # Ubuntu version
df -h               # Disk usage
free -h             # Memory usage
top                 # Running processes
htop                # Better process viewer

Package Management¤

Bash
# Cập nhật danh sách packages
sudo apt update

# Upgrade tất cả packages
sudo apt upgrade

# Cài đặt package
sudo apt install package_name

# Gỡ cài đặt
sudo apt remove package_name
sudo apt purge package_name    # Xóa cả config

# Tìm kiếm package
apt search keyword

Troubleshooting¤

VMware Compatibility¤

VMware Workstation Pro 17+

Từ phiên bản 17 trở lên, VMware hỗ trợ chạy cùng WSL2:

  • Edit → Preferences → Processor
  • Tích "Enable Hyper-V support" (nếu có)
  • Nếu không có option này, update VMware lên latest version

Performance Tips¤

Bash
# Giới hạn RAM cho WSL (tạo file .wslconfig trong Windows home)
echo '[wsl2]
memory=4GB
processors=2
swap=2GB' > /mnt/c/Users/$USER/.wslconfig

# Restart WSL để áp dụng
wsl --shutdown

File System Access¤

Bash
# Windows drives được mount tại /mnt/
cd /mnt/c/Users/     # C:\Users\
cd /mnt/d/           # D:\

# Linux home directory
cd ~                 # /home/username/

# Access Linux files từ Windows
\\wsl$\Ubuntu-24.04\home\username\

Hoàn thành!

Bây giờ bạn đã có môi trường WSL2 hoàn chỉnh để phát triển ứng dụng!

Setup task.json AT&T 32 bit¤

task.json At&t 32 bits
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "shell",
      "label": "as: build active file",
      "command": "as",
      "args": [
        "-o",
        "${fileDirname}/${fileBasenameNoExtension}.o",
        "${file}"
      ],
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "problemMatcher": [],
      "group": "build"
    },
    {
      "type": "shell",
      "label": "ld: link active file",
      "command": "ld",
      "args": [
        "-o",
        "${fileDirname}/${fileBasenameNoExtension}",
        "${fileDirname}/${fileBasenameNoExtension}.o"
      ],
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "problemMatcher": [],
      "group": "build",
      "dependsOn": ["as: build active file"]
    },
    {
      "type": "shell",
      "label": "Run assembled program",
      "command": "${fileDirname}/${fileBasenameNoExtension}",
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "group": {
        "kind": "test",
        "isDefault": true
      },
      "dependsOn": ["ld: link active file"]
    },
    {
      "type": "shell",
      "label": "Build and Run",
      "dependsOn": ["as: build active file", "ld: link active file", "Run assembled program"],
      "dependsOrder": "sequence",
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": []
    }
  ]
}
task.json Intel 32 bits
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
  {
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build & Run NASM (elf32)",
            "type": "shell",
            "command": "bash",
            "args": [
                "-c",
                "nasm -f elf32 '${file}' -o '${fileDirname}/${fileBasenameNoExtension}.o' && ld -m elf_i386 '${fileDirname}/${fileBasenameNoExtension}.o' -o '${fileDirname}/${fileBasenameNoExtension}' && '${fileDirname}/${fileBasenameNoExtension}'"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}
task.json khác
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build and Run NASM (elf32)",
            "type": "shell",
            "command": "nasm",
            "args": [
                "-f", "elf32",
                "${file}",
                "-o", "${fileDirname}/${fileBasenameNoExtension}.o"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        },
        {
            "label": "Link (ld)",
            "type": "shell",
            "command": "ld",
            "args": [
                "-m", "elf_i386",
                "${fileDirname}/${fileBasenameNoExtension}.o",
                "-o", "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "dependsOn": "Build and Run NASM (elf32)",
            "problemMatcher": []
        },
        {
            "label": "Run program",
            "type": "shell",
            "command": "${fileDirname}/${fileBasenameNoExtension}",
            "dependsOn": "Link (ld)",
            "problemMatcher": []
        }
    ]
}