如何在WSL2下搭建开发环境

发布时间：2021-07-06 18:04:43 作者：chen
来源：亿速云阅读：849

# 如何在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发行版

1.3 手动安装步骤（可选）

如果自动安装失败，可执行分步安装：

# 启用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

1.4 安装Linux发行版

Microsoft Store提供多种发行版选择： - Ubuntu（推荐） - Debian - Kali Linux - Alpine Linux等

安装完成后，通过开始菜单或命令行启动：

wsl -d <发行版名称>

二、基础环境配置

2.1 系统更新

首次启动后立即执行：

sudo apt update && sudo apt upgrade -y

2.2 配置APT镜像源（国内用户）

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

2.3 安装基础工具包

sudo apt install -y build-essential git curl wget zsh unzip tar gcc g++ make cmake

2.4 配置SSH

sudo apt install openssh-server
sudo service ssh start
# 设置开机自启
sudo systemctl enable ssh

三、开发环境搭建

3.1 版本控制工具

Git配置

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

安装Git LFS

sudo apt install git-lfs
git lfs install

3.2 编程语言环境

Node.js开发环境

推荐使用nvm管理多版本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

Python开发环境

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

Java开发环境

sudo apt install openjdk-17-jdk maven gradle

Go开发环境

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

3.3 数据库环境

MySQL安装

sudo apt install mysql-server
sudo service mysql start
sudo mysql_secure_installation

Redis安装

sudo apt install redis-server
sudo service redis-server start

MongoDB安装

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

四、开发工具安装

4.1 代码编辑器

VS Code与WSL集成

Windows端安装VS Code
安装”Remote - WSL”扩展
在WSL终端中输入code .即可启动

Neovim配置

sudo apt install neovim
# 安装插件管理器
git clone --depth 1 https://github.com/wbthomason/packer.nvim ~/.local/share/nvim/site/pack/packer/start/packer.nvim

4.2 容器化工具

Docker与WSL2集成

Windows端安装Docker Desktop
设置中启用”Use the WSL 2 based engine”
在WSL中安装docker客户端：

sudo apt install docker.io

Podman安装

. /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

4.3 终端增强

Zsh与Oh My Zsh

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

五、图形界面支持

5.1 GUI应用支持

WSLg已内置支持，可直接运行Linux GUI应用：

sudo apt install gedit
gedit

5.2 远程桌面配置

sudo apt install xrdp
sudo sed -i 's/port=3389/port=3390/g' /etc/xrdp/xrdp.ini
sudo service xrdp start

六、性能优化

6.1 内存限制配置

在%UserProfile%\.wslconfig中添加：

[wsl2]
memory=8GB
processors=4
swap=4GB
localhostForwarding=true

6.2 磁盘性能优化

# 定期清理
sudo apt autoremove
sudo apt clean

6.3 文件系统性能

避免在Windows中直接操作WSL文件
将项目放在WSL文件系统中（\\wsl$\）

七、常见问题解决

7.1 网络问题

# 解决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'

7.2 启动问题

# 重置WSL
wsl --shutdown
wsl -t <发行版名称>
wsl --unregister <发行版名称>

7.3 文件权限问题

# 修复Windows创建文件的权限
sudo umount /mnt/c
sudo mount -t drvfs C: /mnt/c -o metadata

八、进阶配置

8.1 多发行版管理

# 列出已安装发行版
wsl -l -v

# 设置默认发行版
wsl --set-default <发行版名称>

8.2 自定义发行版

# 导出发行版
wsl --export Ubuntu ubuntu_backup.tar

# 导入发行版
wsl --import Ubuntu_New C:\WSL\Ubuntu_New ubuntu_backup.tar

8.3 与Windows集成

# 在WSL中调用Windows程序
explorer.exe .
notepad.exe file.txt

结语

通过本文的详细指导，您应该已经在WSL2中成功搭建了功能完善的开发环境。WSL2的强大之处在于它完美结合了Windows的易用性和Linux的开发效率，为开发者提供了最佳的工作体验。随着不断的实践，您还可以进一步探索更多高级配置和优化技巧，打造真正符合个人需求的开发环境。

提示：定期备份WSL环境（使用wsl --export）可以防止意外数据丢失。同时关注WSL的官方更新，以获取最新功能和性能改进。 “`

本文共计约4650字，涵盖了WSL2开发环境搭建的各个方面。实际使用时可根据具体需求调整部分配置。建议读者按照步骤逐步操作，遇到问题时参考第七节的常见问题解决方法。