手把手教你用VS Code搭建C++开发环境（2024最新指南）

debugdynamo

于 2025-05-14 14:33:49 发布

阅读量766

点赞数 13

文章标签： c++ 开发语言其他

本文链接：https://blog.csdn.net/debugdynamo/article/details/147953864

版权

〇、说在前面的话（必看）

刚接触编程的小伙伴注意了！C++环境搭建绝对是个技术活（别问我怎么知道的🙃），但跟着这篇教程走，保证你30分钟从零开始搞定！最关键的步骤我都用❗️标出来了，漏掉的话程序跑不起来可别哭哦~

一、环境准备清单

VS Code最新版（官网下载速度慢的可以用国内镜像站）
MinGW-w64编译器（版本选9.0以上，后面会教怎么选）
稳定网络（下载扩展需要）
至少2GB硬盘空间（现在的编译器越来越吃空间了😅）

二、安装踩坑预警

▶️ MinGW安装关键选项

在MinGW-w64官网下载时，这几个选项千万不能错：

Architecture：x86_64（64位系统必选）
Threads：posix（兼容性更好）
Exception：seh（性能最优）
版本选最新稳定版（目前推荐gcc-13.2.0）

（👉重要提示：安装路径不要有中文和空格！建议直接装到C:\mingw64）

▶️ 配置环境变量

右键"此电脑"→属性→高级系统设置
环境变量→系统变量→Path→编辑
添加MinGW的bin目录路径（比如C:\mingw64\bin）
❗️验证是否成功：打开cmd输入g++ --version，看到版本号才算OK！

三、VS Code配置六步走

1️⃣ 必装扩展

C/C++（微软官方出品）
Code Runner（一键运行神器）
CMake Tools（进阶玩家必备）

（💡小技巧：按F1输入Extensions: Show Recommended Extensions能快速找到必备插件）

2️⃣ 创建工作区

新建文件夹→用VS Code打开→创建test.cpp文件（这步不能省！）

#include <iostream>
using namespace std;

int main() {
    cout << "Hello 2024!" << endl;
    return 0;
}

3️⃣ 配置智能提示

按Ctrl+Shift+P调出命令面板→输入C/C++: Edit Configurations (UI)

重点设置项：

编译器路径：选MinGW的g++.exe
IntelliSense模式：gcc-x64
C++标准：C++20（推荐最新标准）

4️⃣ 调试配置

创建.vscode/launch.json文件，粘贴以下配置：

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

（❗️注意：miDebuggerPath要根据实际安装路径修改）

5️⃣ 编译任务配置

创建.vscode/tasks.json：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe build active file",
            "command": "C:\\mingw64\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: C:\\mingw64\\bin\\g++.exe"
        }
    ]
}

6️⃣ 终极测试

按F5启动调试→在终端输入任意数字测试输入输出→看到程序正常执行就成功啦！

四、常见问题急救包

❌ 找不到头文件

检查：

编译器路径是否正确
环境变量是否生效
扩展配置中的includePath是否包含标准库路径

❌ 调试时闪退

在main函数最后加：

system("pause");  // Windows专用
// 或
cin.get();        // 跨平台方案

❌ 中文乱码

在tasks.json的args里添加：

"-fexec-charset=GBK",
"-finput-charset=UTF-8"

五、高阶配置技巧

▶️ 多文件编译

创建CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
add_executable(main main.cpp other.cpp)

▶️ 代码格式化

安装Clang-Format扩展→按Alt+Shift+F自动格式化

▶️ 性能调优

在tasks.json的args中添加：

"-O2",  // 优化级别
"-Wall" // 显示所有警告

六、说在最后

配置环境就像搭积木，刚开始可能会手忙脚乱（我当年把MinGW装了3遍才成功😭）。重点是多试错，遇到报错先看错误信息，90%的问题都能在报错提示里找到线索。如果卡住了，欢迎在评论区留言，看到必回！

（🤫彩蛋：按住Ctrl点击变量/函数名可以直接跳转到定义，这招查源码超好用！）