1. 为什么你的 VSCode 写 C/C 总是跑不起来很多刚接触编程的朋友都会遇到同一个场景听说 VSCode 轻量、插件多、界面好看兴冲冲下载安装结果新建一个hello.cpp点运行没反应点调试弹出一堆看不懂的报错。折腾几个小时最后默默换回 Dev-C 或者 Visual Studio。问题不在你而在于 VSCode 本身只是一个编辑器它不像 Visual Studio 那样自带编译器。你要写 C/C必须自己准备三样东西编译器g、编辑器插件C/C 扩展、以及告诉 VSCode「怎么编译、怎么调试」的配置文件。这三样缺一个代码就跑不起来。这篇教程面向 Windows 和 macOS 的新手目标很明确从零把 g 装好把c_cpp_properties.json、tasks.json、launch.json三份配置写对最后成功编译运行hello.cpp并打断点调试。同时我会顺带讲一下怎么用 TaoToken 统一管理 AI 辅助配置时的 Key 和 API 通道让你在让 AI 帮你改配置、解释报错时不用到处找密钥。整个过程我尽量写成「复制就能用」的形式路径该改的地方我会标出来。你跟着做一次跑通的概率很高。2. 前置准备装好 g 和 TaoToken 通道2.1 Windows 安装 gMinGWWindows 上没有自带 g需要装 MinGW。推荐用 nuwen.net 的 MinGW Distro下载下来是个自解压包双击选择安装路径即可。这里有个必须记住的坑安装路径里绝对不能出现中文和空格。比如C:\MinGW是安全的C:\我的软件\MinGW会在后面调试时直接报错。我建议就装在C:\MinGW。装完后把C:\MinGW\bin加到系统环境变量 Path 里。操作路径是设置 → 搜索「环境变量」→ 编辑系统环境变量 → 环境变量 → 在「系统变量」里找到 Path → 新建 → 粘贴C:\MinGW\bin→ 连续确定。验证是否成功按Win R输入cmd然后执行g --version如果输出类似g (GCC) 13.x.x的版本信息说明编译器就位。如果提示「不是内部或外部命令」说明 Path 没配对回去检查路径。2.2 macOS 安装 g其实是 clangmacOS 更简单打开终端执行xcode-select --install系统会弹出安装 Command Line Tools 的窗口点安装等它跑完。装好后验证g --versionmacOS 上g实际指向的是 clang但用法基本一致配置里也能正常工作。注意 macOS 的可执行文件没有.exe后缀后面配置里我会单独说明。2.3 用 TaoToken 统一管理 AI 辅助的 Key配置过程中你大概率会让 AI 帮你解释报错、改 JSON。这时候如果每次都要翻找不同平台的 API Key 会很烦。TaoToken 提供统一的 Key 和 API 通道管理把模型对话、编码辅助的入口收在一处。你可以先到官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要生成或管理密钥时直接进控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite如果你打算长期用 AI 辅助写 C/C、跑 Agent 类任务可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入时统一走这个 API 地址注意它不带 UTM 参数https://taotoken.net/api配置文档在这里遇到字段不清楚可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite3. 可复制的三份 JSON 配置3.1 建立工作目录和 .vscode 文件夹先在你喜欢的位置建一个文件夹比如C:\Code或~/Code名字同样不能有中文。以后所有 C/C 代码都放这个目录下因为调试配置是跟着工作区走的。用 VSCode 打开这个文件夹File → Open Folder然后在里面新建一个名为.vscode的文件夹注意前面有个点再在.vscode里新建三个文件c_cpp_properties.jsontasks.jsonlaunch.json下面三份内容可以直接复制但路径部分要按你的实际安装位置改。3.2 c_cpp_properties.json这份文件告诉 C/C 扩展去哪里找头文件、用哪个编译器。{ configurations: [ { name: Win64, includePath: [${workspaceFolder}/**], defines: [_DEBUG, UNICODE, _UNICODE], compilerPath: C:/MinGW/bin/g.exe, cStandard: c17, cppStandard: c17, intelliSenseMode: gcc-x64 } ], version: 4 }关键字段是compilerPath。Windows 上改成你自己的g.exe完整路径注意 JSON 里用正斜杠/或双反斜杠\\。macOS 用户改成/usr/bin/gintelliSenseMode改成macos-clang-x64。3.3 tasks.json这份文件定义「怎么编译」。VSCode 按 F5 调试前会先跑这个任务。{ version: 2.0.0, tasks: [ { label: g, command: g, args: [ -g, ${file}, -o, ${fileDirname}/${fileBasenameNoExtension}.exe ], problemMatcher: { owner: cpp, fileLocation: [relative, ${workspaceRoot}], pattern: { regexp: ^(.*):(\\d):(\\d):\\s(warning|error):\\s(.*)$, file: 1, line: 2, column: 3, severity: 4, message: 5 } }, group: { kind: build, isDefault: true } } ] }-g表示生成调试信息没有它断点不会生效。macOS 用户把输出后缀.exe去掉改成${fileDirname}/${fileBasenameNoExtension}。3.4 launch.json这份文件定义「怎么调试」是新手最容易卡住的地方。{ version: 0.2.0, configurations: [ { name: (gdb) Launch, type: cppdbg, request: launch, program: ${fileDirname}\\${fileBasenameNoExtension}.exe, args: [], stopAtEntry: false, cwd: ${workspaceRoot}, environment: [], externalConsole: true, MIMode: gdb, miDebuggerPath: C:\\MinGW\\bin\\gdb.exe, preLaunchTask: g, setupCommands: [ { description: Enable pretty-printing for gdb, text: -enable-pretty-printing, ignoreFailures: true } ] } ] }两个字段必须改对miDebuggerPath指向你的gdb.exepreLaunchTask的值要和tasks.json里的label完全一致这里都是g。macOS 用户把program改成${fileDirname}/${fileBasenameNoExtension}miDebuggerPath改成/usr/bin/lldbMIMode改成lldb。4. 验证编译运行 hello.cpp 并断点调试4.1 写第一个程序在工作目录下新建hello.cpp#include iostream using namespace std; int main() { int sum 0; for (int i 1; i 5; i) { sum i; cout i i , sum sum endl; } cout final sum sum endl; return 0; }4.2 编译运行按Ctrl Shift B触发构建任务如果配置正确终端不会报错目录下会生成hello.exemacOS 是hello。想直接运行可以装 Code Runner 插件点右上角三角按钮或者在终端手动执行g -g hello.cpp -o hello.exe ./hello.exe预期输出i 1, sum 1 i 2, sum 3 i 3, sum 6 i 4, sum 10 i 5, sum 15 final sum 154.3 断点调试在第 6 行sum i;左侧点一下出现红点就是断点。按 F5 启动调试程序会停在断点处。左侧变量面板能看到i和sum的实时值按 F10 单步跳过观察sum从 0 变成 1、3、6……这就是调试骨架跑通的标志。如果你在调试时想让 AI 帮你分析变量变化或解释某段逻辑可以用 TaoToken 的模型对话入口把代码和现象贴进去问https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite5. 本篇常见错误排查5.1 中文乱码Windows 终端默认编码和源文件编码不一致时中文会显示成乱码。打开 VSCode 设置搜索encoding把Files: Encoding改成GBK。改完重新保存源文件即可。macOS 一般不需要改保持 UTF-8。5.2 调试时报「找不到 g」或「preLaunchTask 无法启动」先检查三处g 安装路径有没有中文tasks.json的label和launch.json的preLaunchTask是否一致环境变量 Path 是否生效。如果都正常右键 VSCode 图标 → 属性 → 兼容性 → 勾选「以管理员身份运行此程序」部分机器需要这一步。5.3 断点变成灰色空心圈灰色空心圈说明调试器没加载到符号信息。原因通常是编译时没加-g或者program路径指向的可执行文件不对。检查tasks.json的args里是否有-g以及launch.json的program是否和实际生成的 exe 路径一致。5.4 终端运行和 F5 调试冲突如果你勾选了「run in terminal」用 Code Runner 在终端跑代码的同时又按 F5两个进程会打架。二选一即可要么用终端运行要么用 F5 调试。我个人习惯调试时用 F5快速验证输出时用终端。5.5 代码放在别的文件夹就报错这是设计如此。.vscode配置只对当前工作区生效。如果你把cpp文件拖到别的目录再调试VSCode 找不到tasks.json自然报错。解决办法是把代码都放在有.vscode的目录下或者给新目录重新配一份。6. 把 AI 辅助接进你的 C/C 工作流配置跑通只是开始。真正写项目时你会遇到编译报错、链接错误、内存越界这些更麻烦的问题。这时候让 AI 帮你读报错、改配置会省很多时间。TaoToken 的价值在于把 Key 和通道统一起来你不用在多个平台之间切换。需要生成新密钥或管理已有密钥走这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档里对字段、鉴权方式、常见返回码都有说明配置 AI 工具时对照着填就行https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用 Claude Code 这类编码工具可以参考这份接入说明https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite最后提醒一句三份 JSON 里的路径一定要改成你自己的label和preLaunchTask必须一字不差。这两点做到剩下的就是按 F5 的事了。