Windows下使用Visual Studio + WSL2开发Linux项目之环境部署

一、下载安装Visual Studio

1.1 下载地址

推荐下载Visual Studio 2022 预览版，64位架构，速度更快

• Visual Studio 2022 预览版
• Visual Studio 2022
• Visual Studio 2019
  选择community版本下载，免费
  

1.2 安装C++项目工具集

打开安装器，勾选使用 C++ 的桌面开发和使用 C++ 的 Linux 开发，安装目录可以更改

二、安装wsl2

先决条件

必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。 如果使用的是更早的版本，请参阅手动安装页。
BIOS开启CPU虚拟化。

2.1 安装 WSL

• 从微软商店获取Ubuntu 22.04.2 LTS
• 在管理员模式下打开 PowerShell，输入 wsl --install 命令，然后重启计算机。

wsl --install

此命令将启用运行 WSL 并将Ubuntu安装为默认发行版。 （可以更改此默认发行版）。
重新启动计算机，打开安装的Ubuntu-22.04，根据提示逐步设置用户名和密码。

2.2 安装 Windows 终端（推荐）

参考搭建优雅的Windows终端，只需要执行其中的一、二、4.2

下载编程英文字体，解压后全选字体——为所有用户安装

配置完成后，在管理员模式下打开 Windows terminal 或者 PowerShell，执行以下命令，升级WSL。

wsl --update  
wsl --shutdown

2.3 更换清华大学源

打开Windows终端，下拉选择Ubuntu-22.04进入wsl

方法1：手动替换

sudo nano /etc/apt/sources.list

打开Ubuntu 的软件源配置文件，将里面的内容全部删除，替换为以下内容：

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

# 预发布软件源，不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-proposed main restricted universe multiverse

方法2：命令替换

执行如下命令自动替换

sudo sed -i "s@http://.*archive.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g" /etc/apt/sources.list
sudo sed -i "s@http://.*security.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g" /etc/apt/sources.list

更新软件源，安装必要工具

sudo apt update && sudo apt upgrade -y
sudo apt install curl wget git ca-certificates build-essential net-tools -y
sudo apt install g++ gdb make ninja-build rsync zip -y

2.4 WSL ssh 配置

老样子，打开Windows终端，下拉选择Ubuntu-22.04进入wsl

• 重新安装openssh-server

sudo apt remove openssh-server
sudo apt install openssh-server -y
sudo service ssh start
sudo service ssh status
sudo systemctl enable ssh

• 在Ubuntu中查看WSL2的ip（默认为浮动IP，每次重启Ubuntu后改变）

ifconfig

然后可以在Windows terminal中SSH该IP进行登陆。

ssh [用户名]@[ip]

固定WSL IP

为了方便 Visual Studio 通过 ssh 连接 WSL 编译项目，需要固定WSL IP。这里采用端口转发的方法迂回完成此目标。

• 打开Ubuntu22.04，编辑ssh配置文件 /etc/ssh/sshd_config

sudo nano /etc/ssh/sshd_config

• 添加以下两行内容，用于更改端口号为2000，允许ssh密码登录权限

Port 2000
PasswordAuthentication yes

• 防火墙允许2000端口

sudo ufw allow 2000

• 重启ssh服务和防火墙

sudo service ssh restart
sudo ufw reload

• 管理员模式下打开 Windows terminal或powershell，配置端口转换

netsh interface portproxy add v4tov4 listenport=2100 listenaddress=0.0.0.0 connectport=2000 connectaddress=localhost

之后本机就可以通过ssh [用户名]@127.0.0.1 -p 2100来连接WSL啦

三、基于 WSL 2 和 MSBuild 的 Linux 项目

3.1 创建项目

打开Visual Studio，创建新项目—选择 C++ Linux 控制台应用程序—填写项目和解决方案名称、选择项目保存目录，完成创建

3.2 配置跨平台

工具——选项

跨平台——连接管理器——添加，填写WSL IP、用户名、密码。点击连接，接受保存指纹。

可以看到Debug已经出现了WSL 的连接

修改字体，使o0lI便于区分

3.3 生成项目

项目属性——常规——平台工具集，选择WSL2 GCC Toolset，点击确定返回。

VS2019没有WSL2 GCC Toolset，则选择GCC for Windows Subsystem for Linux工具集

按 F7 或者 生成——生成解决方案，可以看到已经成功生成了解决方案

如果重新启动Windows后连接不上WSL的ssh，需要尝试重启 SSH 服务器（在 Ubuntu 上命令为 sudo service ssh restart）

从Windows terminal 进入Ubuntu子系统，进入项目文件夹

cd ~/projects/[项目名称]
# 本文中为 cd ~/projects/cppwsl

进入执行文件生成目录

cd ~/projects/[项目名称]/bin/x64/Debug
# 本文中为 cd ~/projects/cppwsl/bin/x64/Debug

运行执行文件，输出问好。

注：Visual Studio 的 GDB 调试程序可以用于打断点调试，功能很强大。
但最好不要直接用于执行文件，有些函数不一定能执行出来。
执行文件还是老老实实进入Debug目录，手动执行