⚠️ 注意：由于 9 月 wsl2.0 更新了多项功能，重点解决了网络和代理问题，因此下方的一些配置不再需要，请移步 👉新版 WSL2 安装教程👈
博客地址：stormlee.asia/docs/wsl2/w…
欢迎大家前来参观！
开始
本文根据自己在配置 wsl 过程中遇到的问题，整理出一套在 wsl 中配置前端开发环境的流程
因此，省略了创建 wsl 子系统的步骤
按照以下顺序操作即可
还原备份
wsl --import Ubuntu-22.04 e:\Ubuntu-22.04 e:\Ubuntu-22.04.tar
设置默认登录用户
sudo vim /etc/wsl.conf
[user]
default=xxx
[interop]
enable=false
appendWindowsPath=true
[network]
generateResolvConf=false # 为了自定义ip，如果不需要可忽略或设置为true
设置代理
临时给 bash 设置代理，之后 bash 就不用了
采用 v2rayN 进行代理
vim ~/.bashrc
# 以下是文件中的新增
export hostip=$(cat /etc/resolv.conf |grep -oP '(?<=nameserver\ ).*')
alias setss='export all_proxy="socks5://${hostip}:10810"'
alias unsetss='unset all_proxy'
setss # 每次进入终端都配置代理
zsh
sudo apt-get install zsh
chsh -s /bin/zsh # 设为默认终端
oh-my-zsh + 插件
sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
# npm-aliases
git clone https://github.com/lzy1960/zsh-npm-aliases ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/npm-aliases
# zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
# zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
配置 zsh
重启 wsl 终端，输入ezs
配置中包含了 npm 别名、git 别名、样式等配置，直接复制粘贴即可
完成后输入szs使配置生效
新建项目文件夹
mkdir ~/Desktop/project
安装 nvm, nodejs
跟着文档走：learn.microsoft.com/en-us/windo…
配置静态 ip (如果不需要可跳过)
打开/etc/wsl.conf，添加如下代码：
[network]
generateResolvConf=false
打开/etc/resolv.conf，添加nameserver 192.168.50.1
# 在windows中
wsl -d Ubuntu-22.04 -u root ip addr del $(ip addr show eth0 ^| grep 'inet\b' ^| awk '{print $2}' ^| head -n 1) dev eth0
wsl -d Ubuntu-22.04 -u root ip addr add 192.168.50.2/24 broadcast 192.168.50.255 dev eth0
wsl -d Ubuntu-22.04 -u root ip route add 0.0.0.0/0 via 192.168.50.1 dev eth0
wsl -d Ubuntu-22.04 -u root echo nameserver 192.168.50.1 ^> /etc/resolv.conf
powershell -c "Get-NetAdapter 'vEthernet (WSL)' | Get-NetIPAddress | Remove-NetIPAddress -Confirm:$False; New-NetIPAddress -IPAddress 192.168.50.1 -PrefixLength 24 -InterfaceAlias 'vEthernet (WSL)'; Get-NetNat | ? Name -Eq WSLNat | Remove-NetNat -Confirm:$False; New-NetNat -Name WSLNat -InternalIPInterfaceAddressPrefix 192.168.50.0/24;"
然后重启 wsl 终端
ip 可自行修改
重启电脑以后会失效，需要重新运行脚本
配置 git
git config --global user.name xxx # 修改为自己的
git config --global user.email xxxxxx # 修改为自己的
git config --global credential.helper store # 防止每次都需要输入密码
git config --global core.ignorecase false # 开启大小写敏感
git config --global merge.conflictstyle diff3 # 三路合并(3-way merge)，便于合并解决冲突
git config --global credential.helper store # 不用每次询问密码
git config --global merge.ff false # 非快进合并，强制产生merge节点
git config --global pull.ff true # overrides merge.ff when pulling
配置完成，可以开始开发了
使用中可能会遇到的问题
dpkg warning files list file for package 解决方法
sudo apt-get install --reinstall $(sudo apt-get install unzip | grep "warning: files list file for package '" | grep -Po "[^'\n ]+'" | grep -Po "[^']+");
第一句sudo apt-get install unzip是为了获取到所有的问题包，有时需要换成其他的语句
这时候去吃个饭，吃完就好了
Zone.Identifier 文件
在powershell中执行以下命令即可
find . -name "*:Zone.Identifier" -type f -delete
No apport report written because MaxReports is reached already
参考链接：ubuntuforums.org/showthread.…
执行sudo apt install或sudo apt upgrade出现以上报错，可以按照以下方法尝试修复
先执行sudo apt --fix-broken install，看是否能修复
如果不能，并且最后提示类似以下的提示：
......
dpkg: error processing archive /var/cache/apt/archives/libxdamage1_1%3a1.1.5-2build2_i386.deb (--unpack):
trying to overwrite shared '/usr/share/doc/libxdamage1/changelog.Debian.gz', which is different from other instances of package libxdamage1:i386
Errors were encountered while processing:
/var/cache/apt/archives/libcairo-gobject2_1.16.0-5ubuntu2_i386.deb
/var/cache/apt/archives/libwayland-cursor0_1.20.0-1ubuntu0.1_i386.deb
/var/cache/apt/archives/libxdamage1_1%3a1.1.5-2build2_i386.deb
needrestart is being skipped since dpkg has failed
E: Sub-process /usr/bin/dpkg returned an error code (1)
那么去/var/lib/dpkg/info/，可以先查看一下目录下是否存在 Errors 中提示的文件
ls | grep libcairo-gobject
如果存在，会输出：
libcairo-gobject2:amd64.list
libcairo-gobject2:amd64.md5sums
libcairo-gobject2:amd64.postinst
libcairo-gobject2:amd64.postrm
libcairo-gobject2:amd64.shlibs
libcairo-gobject2:amd64.symbols
libcairo-gobject2.control
libcairo-gobject2.list
libcairo-gobject2.md5sums
libcairo-gobject2.shlibs
libcairo-gobject2.symbols
libcairo-gobject2.triggers
删除这些文件，例如
rm -rf libcairo-gobject2* libwayland-cursor* libxdamage*
重新执行sudo apt upgrade，即可成功执行
