WSL中C++环境搭建教程

<p>在WSL中搭建C++环境需先启用WSL并安装Linux发行版，更新系统后安装build-essential、clang、cmake等开发工具，再通过VS Code的Remote - WSL扩展实现高效编辑与调试，配合tasks.json和launch.json配置编译调试任务，利用WSL的Linux文件系统存放项目以提升性能，并使用CMake和Git进行跨平台构建与版本控制，从而在Windows上获得接近原生的Linux C++开发体验。</p>

在Windows子系统WSL中搭建C++环境，核心在于利用WSL提供的一个轻量级Linux发行版，在其内部配置好C++开发所需的编译器（如GCC或Clang）、构建工具（如Make、CMake）以及一个方便的集成开发环境或编辑器。这能让你在Windows上享受到近似原生Linux的开发体验，同时保持Windows操作系统的便利性和生态兼容性。

解决方案

我的经验告诉我，要在WSL里搞定C++环境，其实并不复杂，但有些细节处理好了能省不少心。我通常是这么做的：

1. 启用WSL和安装Linux发行版： 首先，确保你的Windows系统已经启用了WSL功能。这通常通过PowerShell（以管理员身份运行）执行wsl --install命令来完成。它会默认安装Ubuntu。如果你想安装其他发行版，比如Debian或者OpenSUSE，可以在微软商店里搜索并安装。

   • 打开PowerShell (管理员权限)。
   • 运行 wsl --install。
   • 等待安装完成，系统会提示你设置一个Linux用户名和密码。

2. 更新系统和安装基础开发工具： 进入你安装好的WSL环境（可以在Windows搜索栏输入“Ubuntu”或“WSL”打开）。第一件事永远是更新包列表和升级已安装的包，这是个好习惯。

   sudo apt update
   sudo apt upgrade

   然后，安装build-essential包。这个包里包含了GCC/G++编译器、Make构建工具以及其他一些常用的开发库和头文件，对于C++开发来说，这是个一站式解决方案。

   sudo apt install build-essential

   如果你偏爱Clang编译器，或者你的项目有这方面的要求，也可以单独安装它：

   sudo apt install clang

   对于更复杂的项目，CMake几乎是标配，它能帮你管理构建过程，尤其是跨平台项目。

   sudo apt install cmake

3. 配置Visual Studio Code进行远程开发： 这是我个人觉得WSL C++开发最舒服的地方。在Windows上安装Visual Studio Code（简称VS Code）。

   • 在VS Code中安装“Remote - WSL”扩展。
   • 安装完成后，你可以在VS Code左下角看到一个绿色的远程连接图标。点击它，选择“New WSL Window”或者“Connect to WSL”来打开一个WSL环境下的VS Code窗口。
   • 当你在WSL窗口中打开一个文件夹时，VS Code会自动在WSL内部安装一个VS Code Server。
   • 在WSL环境下的VS Code中，你需要安装C/C++扩展（通常是Microsoft提供的那个）。这个扩展会在WSL内部运行，并使用你WSL里的编译器和调试器。
   • 一个简单的例子： 创建一个main.cpp文件，内容是#include <iostream>\nint main() { std::cout << "Hello from WSL C++!" << std::endl; return 0; }。
     • 在VS Code中，按Ctrl+Shift+B（或Cmd+Shift+B），选择“C/C++: g++.exe build active file”。VS Code会自动生成一个tasks.json文件，配置好编译命令。
     • 你也可以手动创建.vscode/tasks.json和.vscode/launch.json来精细控制编译和调试过程。比如，一个简单的tasks.json可能长这样：

       {
           "version": "2.0.0",
           "tasks": [
               {
                   "label": "build hello",
                   "type": "shell",
                   "command": "g++",
                   "args": [
                       "-g",
                       "main.cpp",
                       "-o",
                       "hello"
                   ],
                   "group": {
                       "kind": "build",
                       "isDefault": true
                   },
                   "problemMatcher": [
                       "$gcc"
                   ],
                   "detail": "Generated task for building C++ project."
               }
           ]
       }

       以及一个launch.json用于调试：

       {
           "version": "0.2.0",
           "configurations": [
               {
                   "name": "Debug hello",
                   "type": "cppdbg",
                   "request": "launch",
                   "program": "${workspaceFolder}/hello",
                   "args": [],
                   "stopAtEntry": false,
                   "cwd": "${workspaceFolder}",
                   "environment": [],
                   "externalConsole": true,
                   "MIMode": "gdb",
                   "setupCommands": [
                       {
                           "description": "Enable pretty printing for gdb",
                           "text": "-enable-pretty-printing",
                           "ignoreFailures": true
                       }
                   ],
                   "preLaunchTask": "build hello" // 确保调试前先编译
               }
           ]
       }

       这样，你就可以在WSL环境下，像在原生Linux里一样，通过VS Code进行C++的编写、编译和调试了。

为什么选择WSL而不是原生Windows或虚拟机来开发C++？

我个人觉得，WSL的出现完美解决了Windows开发者在C++领域的一些痛点。以前要么是MinGW/MSVC的生态割裂，要么是虚拟机那笨重的资源占用和文件共享的麻烦。

首先，WSL提供了近乎原生的Linux开发体验。这意味着你可以直接使用Linux的包管理器（apt、dnf等）安装各种库和工具，而无需担心Windows上那些复杂的依赖问题或寻找对应的Windows版本。很多开源C++项目，尤其是那些在Linux环境下开发和测试的项目，在WSL中编译和运行会更加顺畅，避免了各种头文件路径、链接库的问题。我记得有一次在Windows上编译一个依赖了很多Linux系统库的项目，简直是灾难，换到WSL就迎刃而解了。

其次，性能优势显著。相比于完整的虚拟机（如VirtualBox、VMware），WSL的启动速度更快，资源占用更低，因为它直接利用了Windows内核的一些功能，而不是完全模拟一套硬件。这对于日常开发来说，体验上的提升是非常明显的。你可以在后台运行WSL，几乎感觉不到它的存在。

再者，与Windows的良好集成。WSL允许你直接访问Windows文件系统（通过/mnt/c/等路径），也允许Windows应用程序（比如VS Code）直接连接到WSL环境。这种无缝的切换和集成，使得你在享受Linux强大开发环境的同时，也能继续使用Windows上习惯的桌面应用和工具。比如，我可以在WSL里编译代码，然后用Windows上的Chrome浏览器查看本地服务器的输出，这种便利性是虚拟机难以比拟的。它不像虚拟机那样，感觉是“另一个操作系统”，WSL更像是Windows的一个强大扩展。

如何在WSL中高效调试C++代码？

调试，这可是C++开发里最考验耐心的环节之一。在WSL里，最直接的办法当然是GDB，但结合VS Code，效率能提升好几个档次。

首先，确保你的WSL环境里安装了GDB：

sudo apt install gdb

有了GDB，你就可以在命令行里直接用它来调试编译好的程序，比如 gdb ./my_program。但我更倾向于在VS Code里进行图形化调试。

在VS Code中，配置launch.json是关键。就像前面解决方案里给出的示例，你需要告诉VS Code你的程序在哪里，用哪个调试器（这里是gdb），以及一些其他的调试参数。

• "type": "cppdbg" 指明了这是C++调试。
• "request": "launch" 表示启动一个程序并调试。
• "program": "${workspaceFolder}/your_executable_name" 指向你编译生成的可执行文件。
• "MIMode": "gdb" 明确了使用GDB作为底层调试器。
• "preLaunchTask": "build your_project" 这个设置非常有用，它能确保你在每次调试前，VS Code都会自动执行你定义的编译任务，避免调试旧代码。

当你设置好这些，就可以在代码里设置断点，然后点击VS Code左侧的运行和调试按钮，选择你配置好的调试任务，程序就会在WSL里启动，并在断点处暂停。你可以查看变量、单步执行、进入函数等，所有这些操作都在VS Code的图形界面下完成，体验和在原生Windows上调试C++代码没什么两样。

对于使用Clang编译器的项目，你也可以考虑使用LLDB作为调试器，它与Clang配合得很好。安装LLDB也很简单：sudo apt install lldb，然后在launch.json中将"MIMode": "gdb"改为"MIMode": "lldb"。不过，GDB在Linux社区的普及度更高，文档和社区支持也更丰富。

WSL中C++项目管理与跨平台兼容性有什么需要注意的？

C++项目管理，尤其涉及到跨平台，总是有些让人头疼的小细节。WSL虽然提供了一个Linux环境，但它毕竟还是运行在Windows上的，所以有些地方需要我们特别留意。

1. 文件系统性能与位置： 这是一个我踩过坑的地方。WSL的文件系统（比如/home/user/my_project）性能要远优于直接访问Windows文件系统（比如/mnt/c/Users/user/Documents/my_project）。如果你把C++项目放在Windows的文件系统下，然后在WSL里编译，你会发现编译速度明显变慢，尤其是有大量文件操作的项目。我的建议是，把你的C++项目代码都放在WSL的Linux文件系统里。如果你需要与Windows共享文件，可以使用Git或者其他版本控制系统来同步，而不是直接在/mnt/c下工作。

2. 路径分隔符与环境变量： Linux使用正斜杠/作为路径分隔符，而Windows使用反斜杠\。虽然在WSL中，大部分Linux工具会正确处理路径，但当你需要在Windows和WSL之间传递路径时，或者在一些脚本中硬编码路径时，务必注意这一点。环境变量也是类似，WSL有自己的Linux环境变量，与Windows的环境变量是独立的，虽然WSL会尝试合并一部分，但最好还是在WSL内部管理Linux相关的环境变量。

3. 跨平台构建工具：CMake是你的好朋友。 对于复杂的C++项目，尤其是那些需要支持Windows、Linux、macOS等多个平台的项目，CMake几乎是不可或缺的。它能够生成各种构建系统（如Makefile、Visual Studio项目文件），让你只需编写一份CMakeLists.txt，就能在不同环境下构建项目。在WSL中，你可以像在原生Linux上一样使用CMake生成Makefile，然后用make命令编译。 例如，你的CMakeLists.txt可能长这样：

cmake_minimum_required(VERSION 3.10)
project(MyCppProject CXX)

add_executable(my_app main.cpp)

然后在WSL的项目目录下：

mkdir build
cd build
cmake ..
make

这样，my_app可执行文件就会在build目录下生成。

4. 版本控制：在WSL中安装Git。 虽然你可能在Windows上已经安装了Git，但为了避免潜在的路径问题和权限问题，我建议在WSL内部也安装Git：

sudo apt install git

然后，在WSL里进行Git操作，这样可以确保文件权限、行尾符（CRLF vs LF）等问题得到正确处理，尤其是在团队协作时，这能减少很多不必要的麻烦。

5. 库依赖管理： 在Linux环境下，库的依赖管理相对直接，通过包管理器安装即可。但在WSL中，如果你需要一些特定的、不在官方源里的库，可能就需要手动编译安装。这和原生Linux的经验是完全一致的。要注意的是，你安装在WSL里的库，是不能直接被Windows上的MSVC或MinGW编译器使用的，反之亦然。它们是两个独立的开发环境。