win11+WSL2+VS code 简易开发环境搭建

WSL2 安装

• 打开主板 BIOS 的虚拟化选项，如果你是这几年新买的电脑，默认这项是打开的

• 安装过程

  • 启动 WSL：用管理员身份打开 PowerShell，然后在PowerShell中，输入下面的命令

  dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  

  • 若上一步出现错误 => “操作完成，但未启用 Microsoft-Windows-Subsystem-Linux 功能”，则在控制面板中启用“适用于 Windows 的 Linux 子系统”和“虚拟机平台”功能 （如下图红框 2 个选项），选择后会提示重启电脑
  • 启动虚拟机给功能：同样在PoweShell中输入下面的命令，输入完命令后，要重启一下电脑，然后再进行第三步（这里我没有重启，应该和上面勾选后重启有关）

  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  

  • 下载 Linux 内核更新包
  • 将WSL2设置为默认版本：打开 PowerShell，然后在安装新的 Linux 发行版时运行以下命令，将 WSL 2 设置为默认版本，命令如下：

  wsl --set-default-version 2
  

• 安装 Ubuntu 发行版：打开 Microsoft Store，搜索 WSL2 并选择你偏好的Linux分发版（此方法默认将 WSL2 安装到 C 盘，若想指定位置，则参考下面步骤）
  

• 指定位置安装 WSL

  • 手动下载适用于 Linux 的 Windows 子系统发行版包
    
  • 下载后可以得到一个后缀名为 .appx 的文件，将其后缀名改为 .zip，然后解压到自定义安装目录中
    
  • 进入解压后的文件，点击 Ubuntu 安装 WSL（以下是 ubuntu18.04）
    

• 通过以下命令修改 Ubuntu 更新源，更新源可参考Ubuntu 镜像使用帮助

# 首先备份源列表
sudo cp /etc/apt/sources.list /etc/apt/sources.list_backup
# 修改更新源
sudo vim /etc/apt/sources.list
sudo apt update
sudo apt upgrade

• Ubuntu 20.04 更新源报错，可将更新源里软件源的 https 改成 http
  
  修改如下：

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse

• 修改 python 版本（可选），参考自Ubuntu18.04将Python3.6升级到Python3.7

  • 通过 “python -V” 或 “python3 -version” 查看 python 版本
  • 安装自己所需版本的 python，如 “sudo apt install python3.7”
  • 删除旧的软连接，如果还没安装 pip3，就不用删除 pip3

  sudo rm -rf /usr/bin/python3
  sudo rm -rf /usr/bin/pip3
  

  • 新增新的软连接

  # 获取软连接位置
  python37path=`which python3.7`
  # 添加python3的软链接
  sudo ln -s  $python37path /usr/bin/python3
  # 添加 pip3 的软链接
  sudo ln -s  $python37path /usr/bin/pip3
  # 添加3.7版本的apt_pkg
  cd /usr/lib/python3/dist-packages
  sudo cp apt_pkg.cpython-36m-x86_64-linux-gnu.so apt_pkg.cpython-37m-x86_64-linux-gnu.so
  # 测试是否安装成功了
  python3 --version
  

• 配置图形界面（可选），参考WSL2 Ubuntu GUI 图形用户界面，以下是相关命令

# 更新
sudo apt update
sudo apt upgrade
# 安装相应软件
sudo apt install xrdp
sudo apt install xfce4 xfce4-goodies
# 添加相应配置，具体看视频
sudo vim /etc/xrdp/xrdp.ini
echo xfce4-session > ~/.xsession
sudo /etc/xrdp/start.sh

sudo /etc/init.d/xrdp start           # 启动
sudo /etc/init.d/xrdp restart         # 重启
sudo /etc/init.d/xrdp stop            # 停止

注：我使用了 2 个 WSL，两者的地址相同，当连接 WSL01 后断开连接，接着连接 WSL02 时会出现问题（我这里是进不去界面）

WSL 卸载

• 通过 “wsl --list” 查看安装的系统
• 通过 “wsl --unregister Ubuntu系统的名称”
• 通过 “wsl --list” 验证是否卸载成功
  

VS code 配置

• 下载并安装 VS code
• 打开 VS code 并安装相应插件，这里安装 “Remote-WSL” 插件，其他开发必要插件自行配置。WSL 里的插件并不会继承原主机的插件，需要重新下载安装
  
• 连接 WSL，成功后会打开一个新的窗口
  
• 在 VS code 中打开终端并查看相应的环境
  

参考：【VSCode】使用vscode 配置Linux子系统开发环境（remote wsl）

• 若出现问题 => 无法写入文件 "vscode-remote://wsl+ubuntu-18.04…”，则可能需要改变权限，具体如下

# 其中 <directory_project> 为代码存放目录，譬如 /code
sudo chown -R $USER <directory_project>