如何在VSCode中运行调试C++文件 零基础入门操作求助

前置准备（90%运行失败问题出在这步） #

• 先装C++编译器，不要上来先装VSCode插件：
  • Windows系统安装MinGW-w64，安装时选seh架构版本，安装路径全程不能有中文、空格，推荐直接装到根目录比如D:\MinGW。安装完成后把D:\MinGW\bin路径添加到系统环境变量的Path项中，验证方式：打开新的命令提示符窗口输入g++ --version，能正常输出版本号即为配置成功，提示“不是内部或外部命令”就检查路径填写是否正确，配置完环境变量必须重启所有已打开的终端和VSCode才会生效
  • Mac系统直接打开终端输入xcode-select --install，按提示完成安装后，终端输入clang++ --version能正常输出版本号即可
  • Linux（Debian/Ubuntu系）直接在终端输入sudo apt install build-essential完成安装即可
• VSCode端只需要安装微软官方发布的C/C++扩展，不要安装第三方的C++一键运行类插件，这类插件大概率会篡改默认配置造成冲突，安装完重启一次VSCode

Hello World 跑通全流程 #

• 新建一个全英文路径、无空格、无特殊字符的文件夹作为代码工作区，比如D:\cpp_learn，不要把工作区放在中文路径的桌面、不要用中文命名文件夹，路径解析错误是新手最高发的问题
• 用VSCode打开这个工作区文件夹，新建代码文件命名为hello.cpp，写入测试代码：

#include <iostream>
using namespace std;

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

• 点击代码编辑区激活窗口，直接按F5启动调试，弹出环境选择菜单时依次选择C++ (GDB/LLDB)、你刚安装的对应编译器（Windows选g++.exe，Mac选clang++），VSCode会自动在工作区下生成.vscode配置目录，里面的tasks.json（编译配置）和launch.json（调试配置）不需要手动修改，自动生成的内容完全适配新手使用
• 再次按F5，就能在终端看到Hello World!的输出，点击代码行号旁的位置打红点设置断点，调试功能可以直接正常使用

常见异常排查 #

• 提示“找不到g++/cl.exe”：回到编译器安装步骤检查环境变量配置，确认配置后重启VSCode
• 提示“文件不存在/路径访问错误”：检查工作区从盘符到代码文件的完整路径是否存在中文、空格、特殊字符，全部替换成英文即可
• 按F5无响应、配置错乱：直接删除工作区下的.vscode文件夹，回到跑通流程步骤重新按F5自动生成配置即可，不要直接抄网上其他环境的配置文件，不同设备的编译器路径、系统环境不一致，抄来的配置基本都会报错
• 运行后终端一闪而过：在main函数的return 0;语句前加一行system("pause");，或者把VSCode默认终端改成CMD/PowerShell，不要用Git Bash作为C++运行的默认终端

入门学习建议 #

• 入门阶段不要折腾自定义配置，先用自动生成的默认配置稳定跑通代码，等对编译、调试流程有基本认知后再按需调整配置
• 不要看零散的碎片化教程，优先看官方文档的C++入门章节，步骤没有冗余，适配最新版本的VSCode，不会出现教程和实际界面不一致的问题

新手最容易犯的错误就是跳过编译器安装直接装插件、手动改自己看不懂的配置项，这两个操作避开，基本不会遇到卡壳的问题

内容的提问来源于stack exchange，提问作者Samuel Rodriguez