Windows11 WSL安装Ubuntu 24.04无GUI版全攻略

1. Windows11 WSL环境下的Ubuntu 24.04无GUI安装指南

作为长期使用WSL进行开发的工程师，我发现很多同行在安装最新版Ubuntu时总会遇到各种"坑"。本文将分享我在Windows11上通过WSL安装Ubuntu 24.04 LTS的无图形界面版完整流程，包含从环境准备到系统优化的全链路实操记录。

2. 环境准备与基础安装

2.1 启用WSL功能组件

在管理员权限的PowerShell中执行：

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

重启后设置WSL2为默认版本：

powershell复制wsl --set-default-version 2

注意：如果系统未启用虚拟化，需进入BIOS开启Intel VT-x/AMD-V功能。部分品牌机还需关闭Hyper-V兼容模式。

2.2 下载Ubuntu 24.04镜像

微软商店提供的镜像可能不是最新版，推荐手动下载：

powershell复制wsl --install -d Ubuntu-24.04

若下载缓慢，可先获取离线包：

powershell复制Invoke-WebRequest -Uri https://aka.ms/wslubuntu2404 -OutFile Ubuntu.appx -UseBasicParsing
Rename-Item .\Ubuntu.appx .\Ubuntu.zip
Expand-Archive .\Ubuntu.zip .\Ubuntu
cd .\Ubuntu
.\ubuntu2404.exe

3. 系统初始化配置

3.1 首次启动设置

安装完成后会自动进入初始化流程：

1. 设置UNIX用户名（建议与Windows用户名不同）
2. 输入并确认密码（不会显示字符）
3. 等待自动完成软件包更新

3.2 更换国内软件源

bash复制sudo sed -i 's|http://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list
sudo apt update && sudo apt upgrade -y

4. 开发环境配置实战

4.1 基础工具链安装

bash复制sudo apt install -y build-essential git curl wget zsh

4.2 Docker集成方案

1. 在Windows端安装Docker Desktop
2. 启用设置中的"Use the WSL 2 based engine"
3. WSL内安装客户端工具：

bash复制curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

4.3 CUDA开发环境

需确保Windows已安装NVIDIA驱动：

bash复制wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install -y cuda-toolkit-12-4

5. 网络与存储优化

5.1 解决localhost代理问题

在%USERPROFILE%.wslconfig中添加：

ini复制[experimental]
autoMemoryReclaim=gradual
networkingMode=mirrored
dnsTunneling=true
firewall=true
autoProxy=true

5.2 跨系统文件访问

• Windows访问Linux：\\wsl$\Ubuntu-24.04\home\<user>
• Linux访问Windows：/mnt/c/Users/<user>

重要：避免直接在/mnt下进行git操作，会有权限问题。建议将项目放在Linux原生目录。

6. 常见问题排错指南

6.1 启动闪退问题

检查日志定位原因：

powershell复制wsl --system
dmesg | grep -i error

常见解决方法：

1. 重置WSL：wsl --unregister Ubuntu-24.04
2. 修复镜像：wsl --import Ubuntu-24.04 C:\wsl\ubuntu .\install.tar.gz

6.2 网络连接异常

临时解决方案：

bash复制sudo rm /etc/resolv.conf
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
sudo chattr +i /etc/resolv.conf

7. 高级使用技巧

7.1 内存限制配置

创建%USERPROFILE%.wslconfig文件：

ini复制[wsl2]
memory=8GB
processors=4
localhostForwarding=true

7.2 系统备份迁移

导出当前系统：

powershell复制wsl --export Ubuntu-24.04 ubuntu24-backup.tar

导入到新位置：

powershell复制wsl --import Ubuntu-24.04 C:\wsl\ubuntu-new ubuntu24-backup.tar

经过三个月的实际使用验证，这套配置在Ryzen 7 5800H/32GB内存的开发机上能稳定运行多个Docker容器和CUDA计算任务。建议定期执行wsl --shutdown来释放内存碎片，遇到异常时先检查/var/log/apt/term.log中的安装记录。