VSCode搭建C++编程环境手把手教你配置VSCode运行C++-VSCode-PHP中文网

VSCode搭建C++编程环境手把手教你配置VSCode运行C++

看不見的法師

发布： 2025-08-12 19:50:02

原创

1111人浏览过

首先确保已正确配置mingw-w64并将其bin目录添加到系统环境变量path中，1. 检查c_cpp_properties.json中的"include path"是否包含头文件路径；2. 确认tasks.json中使用-i选项指定头文件路径；3. 验证编译器能否通过命令行调用，若问题依旧，尝试重启vscode或重新生成配置文件，最终确保所有路径配置与实际安装路径一致，从而解决头文件找不到的问题。

VSCode搭建C++编程环境手把手教你配置VSCode运行C++

无需多言，本篇文章的目标就是让你快速上手，在VSCode中配置出一个能跑C++代码的环境。告别对着黑框框发呆，开始你的C++编程之旅。

解决方案

安装VSCode： 这就不用多说了吧，去官网下载安装。

立即学习“C++免费学习笔记（深入）”；
安装MinGW-w64： 这是Windows下C++编译器的常用选择。
- 访问https://www.php.cn/link/8e959726dba7c579f0a05b0b62597fb0，下载安装MSYS2。
- 打开MSYS2 MinGW 64-bit终端（重要！）。
- 输入命令
```
pacman -S mingw-w64-x86_64-gcc
```
  登录后复制
  ，按提示安装gcc编译器。
- 安装完成后，将MinGW-w64的bin目录添加到系统环境变量Path中。例如，
```
C:msys64mingw64in
```
  登录后复制
  。验证方法：在cmd中输入
```
gcc -v
```
  登录后复制
  ，如果能显示gcc版本信息，就说明配置成功了。
安装C/C++ Extension for VSCode： 打开VSCode，在扩展商店搜索"C/C++"，安装Microsoft官方的C/C++扩展。
配置
```
tasks.json
```
登录后复制
：这是用于构建项目的配置文件。
- 创建一个简单的C++源文件，比如
```
hello.cpp
```
  登录后复制
  。
- 在VSCode中打开该文件。
- 按下
```
Ctrl+Shift+P
```
  登录后复制
  （或者
```
Cmd+Shift+P
```
  登录后复制
  ），输入"Tasks: Configure Build Task"，选择"C/C++: g++.exe build active file"。
- VSCode会自动生成一个
```
tasks.json
```
  登录后复制
  文件。可以根据需要修改它。一个简单的
```
tasks.json
```
  登录后复制
  示例：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe build active file",
            "command": "C:\msys64\mingw64\bin\g++.exe", // 替换成你的g++.exe路径
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "Task generated by Debugger."
        }
    ]
}

登录后复制

配置
launch.json
登录后复制
：这是用于调试的配置文件。
- 按下
```
Ctrl+Shift+D
```
  登录后复制
  （或者
```
Cmd+Shift+D
```
  登录后复制
  ），点击"create a launch.json file"。
- 选择"C++ (GDB/LLDB)" -> "g++.exe build and debug active file"。
- VSCode会自动生成一个
```
launch.json
```
  登录后复制
  文件。一个简单的
```
launch.json
```
  登录后复制
  示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C/C++: g++.exe build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "C:\msys64\mingw64\bin\gdb.exe", // 替换成你的gdb.exe路径
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe build active file"
        }
    ]
}

登录后复制

编写并运行你的C++代码： 现在你可以编写你的C++代码了。按下
```
Ctrl+Shift+B
```
登录后复制
（或者
```
Cmd+Shift+B
```
登录后复制
）构建项目，然后按下
```
F5
```
登录后复制
运行程序。

为什么我的VSCode编译C++代码总是提示找不到头文件？

这通常是因为编译器找不到头文件的路径。解决办法：

检查
```
c_cpp_properties.json
```
登录后复制
： VSCode的C/C++扩展使用
```
c_cpp_properties.json
```
登录后复制
文件来配置头文件路径。按下
```
Ctrl+Shift+P
```
登录后复制
，输入"C/C++: Edit Configurations (UI)"，打开配置界面。在"Include path"中添加你的头文件路径。比如，如果你使用了某个第三方库，需要将该库的头文件目录添加到这里。

小艺
华为公司推出的AI智能助手

549

查看详情
检查系统环境变量： 确保MinGW-w64的bin目录已经添加到系统环境变量Path中。
检查编译器选项： 在
```
tasks.json
```
登录后复制
文件中，可以添加
```
-I
```
登录后复制
选项来指定头文件路径。例如：

"args": [
    "-g",
    "-I",
    "C:\path\to\your\include", // 替换成你的头文件路径
    "${file}",
    "-o",
    "${fileDirname}\${fileBasenameNoExtension}.exe"
]

登录后复制

使用绝对路径： 在
```
#include
```
登录后复制
指令中使用绝对路径，例如
```
#include "C:\path\to\your\header.h"
```
登录后复制
。但这通常不是一个好的做法，因为它会使你的代码难以移植。

如何在VSCode中调试C++代码？

调试是编程过程中不可或缺的一部分。VSCode提供了强大的调试功能。

设置断点： 在你想要暂停执行的代码行左侧点击，可以设置断点。
启动调试： 按下
```
F5
```
登录后复制
启动调试。
调试工具栏： VSCode会显示一个调试工具栏，你可以使用它来单步执行、跳过、继续执行、查看变量等等。
launch.json
登录后复制
配置：确保你的
```
launch.json
```
登录后复制
文件配置正确。特别是
```
program
```
登录后复制
和
```
miDebuggerPath
```
登录后复制
这两个字段，要指向正确的程序和调试器路径。
GDB： VSCode使用GDB作为调试器。确保你已经安装了GDB，并且将其路径添加到
```
launch.json
```
登录后复制
中。 MinGW-w64自带GDB。

如何在VSCode中使用CMake构建C++项目？

CMake是一个跨平台的构建系统，可以帮助你管理复杂的C++项目。

安装CMake： 去CMake官网下载安装。
安装CMake Tools Extension： 在VSCode中安装CMake Tools扩展。
编写
```
CMakeLists.txt
```
登录后复制
：这是CMake的配置文件。一个简单的
```
CMakeLists.txt
```
登录后复制
示例：

cmake_minimum_required(VERSION 3.0.0)
project(MyProject)

add_executable(MyProject main.cpp)

登录后复制

配置CMake Tools： VSCode会自动检测到
```
CMakeLists.txt
```
登录后复制
文件，并提示你配置CMake Tools。你可以使用CMake Tools提供的命令来构建、运行和调试你的项目。
构建项目： 使用CMake Tools提供的构建命令来构建项目。例如，点击状态栏上的"Build"按钮。
运行和调试： 使用CMake Tools提供的运行和调试命令来运行和调试你的项目。

使用CMake的好处是可以方便地管理依赖项、生成不同平台的构建文件等等。虽然配置稍微复杂一些，但对于大型项目来说，CMake是必不可少的。

以上就是VSCode搭建C++编程环境手把手教你配置VSCode运行C++的详细内容，更多请关注php中文网其它相关文章！