C++在Windows子系统WSL中搭建环境方法-C++-PHP中文网

<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>

c++在windows子系统wsl中搭建环境方法

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

解决方案

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

启用WSL和安装Linux发行版： 首先，确保你的Windows系统已经启用了WSL功能。这通常通过PowerShell（以管理员身份运行）执行
```
wsl --install
```
登录后复制
命令来完成。它会默认安装Ubuntu。如果你想安装其他发行版，比如Debian或者OpenSUSE，可以在微软商店里搜索并安装。
- 打开PowerShell (管理员权限)。
- 运行
```
wsl --install
```
  登录后复制
  。
- 等待安装完成，系统会提示你设置一个Linux用户名和密码。
更新系统和安装基础开发工具： 进入你安装好的WSL环境（可以在Windows搜索栏输入“Ubuntu”或“WSL”打开）。第一件事永远是更新包列表和升级已安装的包，这是个好习惯。
```
sudo apt update
sudo apt upgrade
```
登录后复制
然后，安装
```
build-essential
```
登录后复制
包。这个包里包含了GCC/G++编译器、Make构建工具以及其他一些常用的开发库和头文件，对于C++开发来说，这是个一站式解决方案。
```
sudo apt install build-essential
```
登录后复制
如果你偏爱Clang编译器，或者你的项目有这方面的要求，也可以单独安装它：

立即学习“C++免费学习笔记（深入）”；
```
sudo apt install clang
```
登录后复制
对于更复杂的项目，CMake几乎是标配，它能帮你管理构建过程，尤其是跨平台项目。
```
sudo apt install cmake
```
登录后复制

配置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的一个强大扩展。

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

查看详情

如何在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编译器使用的，反之亦然。它们是两个独立的开发环境。

以上就是C++在Windows子系统WSL中搭建环境方法的详细内容，更多请关注php中文网其它相关文章！