手把手教你用VS Code搭建C++开发环境（保姆级教程）

「已注销」

墨衍会员 · AI 创作全网分发码龄2年

关注

原创最新推荐文章于 2026-05-13 09:34:22 发布 729 阅读 AI 写同款· GEO 优化 ›

VSCode如何快速搭建C/C++环境说明下如何在VSCode下面搭建C/C++环境以及运行。阅读详情

🔥 为什么要用VS Code写C++？

（说真的）现在都2024年了，还有人在用Visual Studio那个庞然大物吗？！VS Code轻量级+插件自由组合的特性，让它成为了C++开发的瑞士军刀！不过配置环境确实是个技术活，今天我就把踩过的坑都给你填平了！

🛠️ 准备工作三件套

1. 安装VS Code（这不用教吧？）

官网下载速度慢的可以用清华镜像站，懂的都懂！

2. 必装插件推荐

C/C++扩展（微软官方出品，必须装！）
Code Runner（一键运行超方便）
CMake Tools（进阶玩家必备）

3. 安装编译器（重点！）

Windows用户看这里👇：

下载MinGW-w64（别下错版本！选x86_64-posix-seh）
安装时记得勾选Add to PATH（不勾你会哭！）
命令行输入 g++ --version 验证（出现版本号才算成功）

Mac/Linux用户直接在终端：

# Mac
brew install gcc

# Ubuntu/Debian
sudo apt install build-essential

⚙️ 配置核心文件（重点中的重点！）

tasks.json - 编译指令配置

按 Ctrl+Shift+P 输入 tasks: Configure Task，选择C/C++: g++.exe

修改配置文件：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "g++",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.exe"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

launch.json - 调试配置

按F5创建调试配置，选择C++ (GDB/LLDB)

修改关键参数：

{
    "configurations": [
        {
            "name": "g++.exe - 生成和调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": true, // 必须设为true才能输入！！
            "MIMode": "gdb",
            "miDebuggerPath": "gdb.exe",
            "preLaunchTask": "C/C++: g++.exe 生成活动文件"
        }
    ]
}

🚀 实战演示（手把手教学！）

创建test.cpp：

#include <iostream>
using namespace std;

int main() {
    cout << "Hello VS Code!" << endl;
    int num;
    cin >> num; // 测试输入功能
    return 0;
}

编译运行三剑客：

Ctrl+S 保存文件
Ctrl+Shift+B 编译
F5 调试运行（或右键Run Code）

看到弹出的黑窗口了吗？恭喜你成功了一半！

💥 常见问题核打击

Q1: 报错「g++不是内部命令」

检查MinGW的bin目录是否加入PATH
VS Code重启！重启！重启！（重要的事说三遍）

Q2: 能编译但无法输入

把launch.json里的 "externalConsole": true
禁用Code Runner的"Run In Terminal"

Q3: 头文件找不到

安装C/C++ Extension后按 Ctrl+Shift+P
选 C/C++: Edit Configurations (UI)
在Include path里添加你的头文件目录

🎯 高级玩法（装逼必备）

多文件编译配置

修改tasks.json的args：

"args": [
    "-g",
    "${fileDirname}/*.cpp", // 编译所有cpp文件
    "-o",
    "${fileDirname}/program.exe"
]

CMake集成

安装CMake和CMake Tools扩展
创建CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyApp)
add_executable(${PROJECT_NAME} *.cpp)

按F7一键编译

🌈 终极优化方案

在.vscode/settings.json中添加：

{
    "C_Cpp.intelliSenseEngine": "Default",
    "editor.formatOnSave": true,
    "files.associations": {
        "*.h": "cpp"
    },
    "code-runner.runInTerminal": true
}