C++新手使用VSCode开发遇#include报错、g++未识别等问题求助

你遇到的两类报错本质上都和本地未正确安装配置C++编译套件有关，按以下步骤依次排查即可：

1. 配置C编译环境解决g识别报错 #

• Windows系统推荐安装MinGW-w64编译套件，安装完成后找到其安装目录下的bin文件夹，完整复制该路径
• 打开系统环境变量编辑界面，在「系统变量」的Path项中新增刚才复制的bin路径，保存所有修改
• 按下Win+R输入cmd打开命令行，输入g++ --version，如果返回版本号信息则说明编译环境配置成功

注意：修改环境变量后需要重启所有已打开的VSCode窗口，否则VSCode不会读取新的环境变量配置

2. 修复#include语句红色波浪线报错 #

• 确认g配置成功后，按下Ctrl+,打开VSCode设置，搜索C_Cpp: Edit Configurations (UI)进入C/C扩展配置页
• 找到「编译器路径」选项，选择刚才安装的MinGW-w64路径下的bin/g++.exe文件
• 找到「IntelliSense 模式」选项，Windows系统选择windows-gcc-x64
• 保存配置后回到代码界面，红色波浪线会自动消失

3. Code Runner运行异常排查 #

• 打开VSCode设置，搜索Code Runner: Executor Map，点击「在settings.json中编辑」
• 找到cpp对应的配置项，确认值为"cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt"
• 如果仍运行失败，勾选Code Runner: Run In Terminal选项，确保运行日志完整展示
• 所有配置修改完成后，重启VSCode再运行代码测试

其他无明确诱因报错排查顺序 #

• 检查代码文件后缀是否为.cpp，不要直接用.txt或其他后缀重命名
• 确认文件保存路径没有中文、空格、特殊字符，否则编译时会出现路径识别失败
• 禁用不必要的VSCode扩展，避免扩展冲突导致的异常报错

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