1. WSL2与Ubuntu24.04环境搭建全攻略最近在Windows系统上折腾开发环境发现WSL2Windows Subsystem for Linux 2配合Ubuntu24.04 LTS的组合特别香。相比传统虚拟机WSL2性能更好、资源占用更低还能直接访问Windows文件系统。下面就把我踩坑无数后总结的完整安装配置流程分享给大家。先说说为什么选择这个组合WSL2基于Hyper-V虚拟化技术提供了接近原生Linux的性能而Ubuntu24.04作为最新的LTS版本不仅软件包新还默认搭载了Python3.12等最新工具链特别适合需要现代开发环境的用户。接下来我会从系统准备到环境优化手把手带你完成全套配置。2. 系统准备与WSL2安装2.1 检查系统要求首先确保你的Windows版本符合要求Windows 10版本2004及更高内部版本19041及以上或Windows 11任何版本64位系统支持虚拟化技术可在任务管理器→性能标签页查看提示家庭版用户需要先启用Hyper-V功能可通过管理员权限运行bcdedit /set hypervisorlaunchtype auto命令开启2.2 安装WSL2核心组件以管理员身份打开PowerShell执行以下命令启用必要功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启计算机后设置WSL2为默认版本wsl --set-default-version 2下载并安装WSL2内核更新包微软官网搜索WSL2 Linux内核更新包获取最新版3. Ubuntu24.04安装与基础配置3.1 获取Ubuntu24.04镜像推荐通过微软商店直接安装打开Microsoft Store搜索Ubuntu 24.04 LTS点击获取并安装或者使用命令行安装wsl --install -d Ubuntu-24.043.2 首次启动与初始化安装完成后首次启动会提示创建用户输入用户名建议与Windows用户名不同设置密码输入时不会显示字符确认密码安装完成后建议立即更新软件包sudo apt update sudo apt upgrade -y3.3 系统基础优化更换国内镜像源以阿里云为例sudo sed -i s|http://archive.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list sudo sed -i s|http://security.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list安装常用工具sudo apt install -y build-essential curl wget git zsh neovim配置默认shell为zshsudo apt install -y zsh chsh -s $(which zsh)4. 高级配置与性能优化4.1 文件系统互通配置WSL2与Windows的文件系统互通Windows访问Linux文件\\wsl$\Ubuntu-24.04\Linux访问Windows文件/mnt/c/对应C盘建议在Linux中创建符号链接方便访问ln -s /mnt/c/Users/你的用户名 ~/winhome4.2 内存与CPU资源限制在Windows用户目录下创建.wslconfig文件注意没有扩展名内容如下[wsl2] memory8GB # 根据你的内存调整 processors4 # 分配的CPU核心数 swap4GB # 交换空间大小 localhostForwardingtrue4.3 GPU加速支持如果你的电脑有NVIDIA显卡确保已安装最新NVIDIA驱动在Ubuntu中安装CUDA工具包sudo apt install -y nvidia-cuda-toolkit验证GPU识别nvidia-smi5. 开发环境配置实战5.1 Python环境搭建Ubuntu24.04默认已安装Python3.12建议配置虚拟环境sudo apt install -y python3-venv python3-pip python3 -m venv ~/.venv/default echo source ~/.venv/default/bin/activate ~/.zshrc5.2 Docker集成安装Docker Desktop for Windows在设置中启用Use the WSL 2 based engine在Ubuntu中安装Docker客户端sudo apt install -y docker.io sudo usermod -aG docker $USER5.3 VS Code远程开发安装VS Code的Remote - WSL扩展在WSL终端中输入code .即可在Windows中打开VS Code并自动连接到WSL环境所有开发工具和扩展都会在WSL环境中运行6. 常见问题解决方案6.1 WSL2无法启动问题如果遇到参考的对象类型不支持尝试的操作错误下载NoLsp.exe工具以管理员身份运行NoLsp.exe C:\windows\system32\wsl.exe6.2 网络连接问题解决WSL2中无法访问某些网络资源的问题sudo bash -c echo [network] /etc/wsl.conf sudo bash -c echo generateResolvConf false /etc/wsl.conf sudo unlink /etc/resolv.conf sudo bash -c echo nameserver 8.8.8.8 /etc/resolv.conf6.3 图形界面支持安装X Server实现GUI支持Windows端安装VcXsrv或MobaXterm在WSL中配置echo export DISPLAY$(awk /nameserver / {print $2} /etc/resolv.conf):0 ~/.zshrc echo export LIBGL_ALWAYS_INDIRECT1 ~/.zshrc7. 系统迁移与备份7.1 迁移WSL到其他分区查看已安装的发行版wsl -l -v导出系统镜像wsl --export Ubuntu-24.04 d:\wsl-ubuntu24.04.tar注销原有发行版wsl --unregister Ubuntu-24.04在新位置导入wsl --import Ubuntu-24.04 d:\wsl\ubuntu24.04 d:\wsl-ubuntu24.04.tar --version 27.2 设置默认用户导入后需要重新设置默认用户在Windows中创建%USERPROFILE%\.wslconfig文件添加内容[user] default你的用户名8. 生产力工具推荐8.1 终端增强安装Windows Terminal并配置在微软商店安装Windows Terminal配置默认启动Ubuntu24.04建议安装Cascadia Code等编程字体8.2 文件管理器集成安装WSL插件后可以在Windows文件资源管理器中直接浏览Linux文件系统。8.3 剪贴板互通配置共享剪贴板安装必要的工具sudo apt install -y xclip wl-clipboard在Windows和WSL中都可以通过clip.exe和wl-copy/wl-paste命令共享剪贴板经过这样一套配置下来你的WSL2Ubuntu24.04环境应该已经非常完善了。我自己的开发工作流已经完全迁移到这个环境实测比传统虚拟机流畅很多特别是文件IO性能有明显提升。如果遇到其他问题建议多查看微软官方WSL文档和Ubuntu社区论坛大部分问题都能找到解决方案。
1. WSL2与Ubuntu24.04环境搭建全攻略最近在Windows系统上折腾开发环境发现WSL2Windows Subsystem for Linux 2配合Ubuntu24.04 LTS的组合特别香。相比传统虚拟机WSL2性能更好、资源占用更低还能直接访问Windows文件系统。下面就把我踩坑无数后总结的完整安装配置流程分享给大家。先说说为什么选择这个组合WSL2基于Hyper-V虚拟化技术提供了接近原生Linux的性能而Ubuntu24.04作为最新的LTS版本不仅软件包新还默认搭载了Python3.12等最新工具链特别适合需要现代开发环境的用户。接下来我会从系统准备到环境优化手把手带你完成全套配置。2. 系统准备与WSL2安装2.1 检查系统要求首先确保你的Windows版本符合要求Windows 10版本2004及更高内部版本19041及以上或Windows 11任何版本64位系统支持虚拟化技术可在任务管理器→性能标签页查看提示家庭版用户需要先启用Hyper-V功能可通过管理员权限运行bcdedit /set hypervisorlaunchtype auto命令开启2.2 安装WSL2核心组件以管理员身份打开PowerShell执行以下命令启用必要功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启计算机后设置WSL2为默认版本wsl --set-default-version 2下载并安装WSL2内核更新包微软官网搜索WSL2 Linux内核更新包获取最新版3. Ubuntu24.04安装与基础配置3.1 获取Ubuntu24.04镜像推荐通过微软商店直接安装打开Microsoft Store搜索Ubuntu 24.04 LTS点击获取并安装或者使用命令行安装wsl --install -d Ubuntu-24.043.2 首次启动与初始化安装完成后首次启动会提示创建用户输入用户名建议与Windows用户名不同设置密码输入时不会显示字符确认密码安装完成后建议立即更新软件包sudo apt update sudo apt upgrade -y3.3 系统基础优化更换国内镜像源以阿里云为例sudo sed -i s|http://archive.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list sudo sed -i s|http://security.ubuntu.com|https://mirrors.aliyun.com|g /etc/apt/sources.list安装常用工具sudo apt install -y build-essential curl wget git zsh neovim配置默认shell为zshsudo apt install -y zsh chsh -s $(which zsh)4. 高级配置与性能优化4.1 文件系统互通配置WSL2与Windows的文件系统互通Windows访问Linux文件\\wsl$\Ubuntu-24.04\Linux访问Windows文件/mnt/c/对应C盘建议在Linux中创建符号链接方便访问ln -s /mnt/c/Users/你的用户名 ~/winhome4.2 内存与CPU资源限制在Windows用户目录下创建.wslconfig文件注意没有扩展名内容如下[wsl2] memory8GB # 根据你的内存调整 processors4 # 分配的CPU核心数 swap4GB # 交换空间大小 localhostForwardingtrue4.3 GPU加速支持如果你的电脑有NVIDIA显卡确保已安装最新NVIDIA驱动在Ubuntu中安装CUDA工具包sudo apt install -y nvidia-cuda-toolkit验证GPU识别nvidia-smi5. 开发环境配置实战5.1 Python环境搭建Ubuntu24.04默认已安装Python3.12建议配置虚拟环境sudo apt install -y python3-venv python3-pip python3 -m venv ~/.venv/default echo source ~/.venv/default/bin/activate ~/.zshrc5.2 Docker集成安装Docker Desktop for Windows在设置中启用Use the WSL 2 based engine在Ubuntu中安装Docker客户端sudo apt install -y docker.io sudo usermod -aG docker $USER5.3 VS Code远程开发安装VS Code的Remote - WSL扩展在WSL终端中输入code .即可在Windows中打开VS Code并自动连接到WSL环境所有开发工具和扩展都会在WSL环境中运行6. 常见问题解决方案6.1 WSL2无法启动问题如果遇到参考的对象类型不支持尝试的操作错误下载NoLsp.exe工具以管理员身份运行NoLsp.exe C:\windows\system32\wsl.exe6.2 网络连接问题解决WSL2中无法访问某些网络资源的问题sudo bash -c echo [network] /etc/wsl.conf sudo bash -c echo generateResolvConf false /etc/wsl.conf sudo unlink /etc/resolv.conf sudo bash -c echo nameserver 8.8.8.8 /etc/resolv.conf6.3 图形界面支持安装X Server实现GUI支持Windows端安装VcXsrv或MobaXterm在WSL中配置echo export DISPLAY$(awk /nameserver / {print $2} /etc/resolv.conf):0 ~/.zshrc echo export LIBGL_ALWAYS_INDIRECT1 ~/.zshrc7. 系统迁移与备份7.1 迁移WSL到其他分区查看已安装的发行版wsl -l -v导出系统镜像wsl --export Ubuntu-24.04 d:\wsl-ubuntu24.04.tar注销原有发行版wsl --unregister Ubuntu-24.04在新位置导入wsl --import Ubuntu-24.04 d:\wsl\ubuntu24.04 d:\wsl-ubuntu24.04.tar --version 27.2 设置默认用户导入后需要重新设置默认用户在Windows中创建%USERPROFILE%\.wslconfig文件添加内容[user] default你的用户名8. 生产力工具推荐8.1 终端增强安装Windows Terminal并配置在微软商店安装Windows Terminal配置默认启动Ubuntu24.04建议安装Cascadia Code等编程字体8.2 文件管理器集成安装WSL插件后可以在Windows文件资源管理器中直接浏览Linux文件系统。8.3 剪贴板互通配置共享剪贴板安装必要的工具sudo apt install -y xclip wl-clipboard在Windows和WSL中都可以通过clip.exe和wl-copy/wl-paste命令共享剪贴板经过这样一套配置下来你的WSL2Ubuntu24.04环境应该已经非常完善了。我自己的开发工作流已经完全迁移到这个环境实测比传统虚拟机流畅很多特别是文件IO性能有明显提升。如果遇到其他问题建议多查看微软官方WSL文档和Ubuntu社区论坛大部分问题都能找到解决方案。
