如何在WSL2下搭建開發環境

# 如何在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集成

1. Windows端安裝VS Code
2. 安裝”Remote - WSL”擴展
3. 在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集成

1. Windows端安裝Docker Desktop
2. 設置中啟用”Use the WSL 2 based engine”
3. 在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開發環境搭建的各個方面。實際使用時可根據具體需求調整部分配置。建議讀者按照步驟逐步操作，遇到問題時參考第七節的常見問題解決方法。