# 如何在WSL2下搭建开发环境 ## 前言 随着Windows Subsystem for Linux（WSL）的迭代升级，WSL2已经成为开发者在Windows系统下进行Linux开发的利器。相比传统虚拟机，WSL2提供了更高效的性能、更完整的系统调用兼容性以及与Windows系统的深度集成。本文将详细介绍如何在WSL2环境下搭建完整的开发环境，涵盖环境配置、常用工具安装、开发环境优化等关键环节。 ## 一、WSL2环境准备 ### 1.1 系统要求检查 - Windows 10版本2004或更高（建议使用Windows 11） - 64位系统架构 - 虚拟化功能已启用（可通过BIOS设置） ### 1.2 安装WSL2 ```powershell # 以管理员身份打开PowerShell执行 wsl --install 此命令将自动完成以下操作： 1. 启用WSL和虚拟机平台功能 2. 下载最新Linux内核更新包 3. 设置WSL2为默认版本 4. 安装默认的Ubuntu发行版
如果自动安装失败，可执行分步安装：
# 启用WSL功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 下载并安装WSL2内核更新包 # 下载地址：https://aka.ms/wsl2kernel # 设置WSL2为默认版本 wsl --set-default-version 2 Microsoft Store提供多种发行版选择： - Ubuntu（推荐） - Debian - Kali Linux - Alpine Linux等
安装完成后，通过开始菜单或命令行启动：
wsl -d <发行版名称> 首次启动后立即执行：
sudo apt update && sudo apt upgrade -y sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list sudo apt update sudo apt install -y build-essential git curl wget zsh unzip tar gcc g++ make cmake sudo apt install openssh-server sudo service ssh start # 设置开机自启 sudo systemctl enable ssh git config --global user.name "Your Name" git config --global user.email "your.email@example.com" git config --global core.editor vim git config --global pull.rebase true sudo apt install git-lfs git lfs install 推荐使用nvm管理多版本：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash source ~/.bashrc nvm install --lts nvm use --lts sudo apt install python3 python3-pip python3-venv # 配置pip镜像源 mkdir -p ~/.pip echo "[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf sudo apt install openjdk-17-jdk maven gradle wget https://go.dev/dl/go1.20.linux-amd64.tar.gz sudo tar -C /usr/local -xzf go1.20.linux-amd64.tar.gz echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc source ~/.bashrc sudo apt install mysql-server sudo service mysql start sudo mysql_secure_installation sudo apt install redis-server sudo service redis-server start wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add - echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list sudo apt update sudo apt install -y mongodb-org sudo systemctl start mongod code .即可启动sudo apt install neovim # 安装插件管理器 git clone --depth 1 https://github.com/wbthomason/packer.nvim ~/.local/share/nvim/site/pack/packer/start/packer.nvim sudo apt install docker.io . /etc/os-release echo "deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/ /" | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list curl -L "https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/Release.key" | sudo apt-key add - sudo apt update sudo apt install podman sudo apt install zsh sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" # tmux sudo apt install tmux # 配置示例 echo "set -g mouse on set -g base-index 1 setw -g pane-base-index 1" > ~/.tmux.conf # screen sudo apt install screen WSLg已内置支持，可直接运行Linux GUI应用：
sudo apt install gedit gedit sudo apt install xrdp sudo sed -i 's/port=3389/port=3390/g' /etc/xrdp/xrdp.ini sudo service xrdp start 在%UserProfile%\.wslconfig中添加：
[wsl2] memory=8GB processors=4 swap=4GB localhostForwarding=true # 定期清理 sudo apt autoremove sudo apt clean \\wsl$\）# 解决DNS解析问题 sudo rm /etc/resolv.conf sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf' sudo bash -c 'echo "[network]" > /etc/wsl.conf' sudo bash -c 'echo "generateResolvConf = false" >> /etc/wsl.conf' # 重置WSL wsl --shutdown wsl -t <发行版名称> wsl --unregister <发行版名称> # 修复Windows创建文件的权限 sudo umount /mnt/c sudo mount -t drvfs C: /mnt/c -o metadata # 列出已安装发行版 wsl -l -v # 设置默认发行版 wsl --set-default <发行版名称> # 导出发行版 wsl --export Ubuntu ubuntu_backup.tar # 导入发行版 wsl --import Ubuntu_New C:\WSL\Ubuntu_New ubuntu_backup.tar # 在WSL中调用Windows程序 explorer.exe . notepad.exe file.txt 通过本文的详细指导，您应该已经在WSL2中成功搭建了功能完善的开发环境。WSL2的强大之处在于它完美结合了Windows的易用性和Linux的开发效率，为开发者提供了最佳的工作体验。随着不断的实践，您还可以进一步探索更多高级配置和优化技巧，打造真正符合个人需求的开发环境。
提示：定期备份WSL环境（使用
wsl --export）可以防止意外数据丢失。同时关注WSL的官方更新，以获取最新功能和性能改进。 “`
本文共计约4650字，涵盖了WSL2开发环境搭建的各个方面。实际使用时可根据具体需求调整部分配置。建议读者按照步骤逐步操作，遇到问题时参考第七节的常见问题解决方法。
免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：is@yisu.com进行举报，并提供相关证据，一经查实，将立刻删除涉嫌侵权内容。
