1. 为什么你的 VS Code 写 C++ 总是「能跑不能调」
很多人第一次在 VS Code 里写 C++，都会经历同一个循环：装插件、写hello.cpp、按 F5，然后弹出一堆看不懂的报错。要么是g++.exe: command not found，要么是断点变成灰色空心圈，要么是终端一闪而过看不到输出。折腾两小时，代码还是那三行。
问题不在你，在于 VS Code 本身只是个编辑器，它不像 Visual Studio 那样自带编译器和调试器。C++ 的编译、链接、调试三件事，需要你自己把工具链接上，再用三个 JSON 文件把「怎么编译、怎么启动调试、头文件去哪找」告诉它。这三个文件分别是tasks.json、launch.json、c_cpp_properties.json，缺一个链路就断。
这篇内容面向的是刚接触 VS Code 的 C++ 学习者，也适合已经能编译但调试总出问题的同学。我会从工具链安装讲到三个配置文件的完整写法，再进一步把 TaoToken 的统一 Key 接进 VS Code 的 AI 补全和错误诊断链路里。也就是说，你最终得到的不只是一个能编译能打断点的环境，还有一个能在你写错std::vector迭代器时直接告诉你哪里越界的 AI 助手。
核心检索词先明确：vscode 配置 c++ 环境，本质是「工具链 + 三个 JSON + 调试器路径」的组合。适合谁？适合 Windows 上用 MinGW-w64 的初学者，也适合想把 AI 补全接进本地 C++ 工程的开发者。下面每一步都给可复制的配置，路径按你自己的安装位置改。
2. 前置准备：MinGW-w64 工具链与 TaoToken 统一 Key
2.1 装工具链，别用老教程里的 MinGW
网上很多教程还在让你下mingw32，那个版本太老，c++17支持不全，std::filesystem直接编不过。现在直接用MinGW-w64，选x86_64-posix-seh这个构建。下载后解压到一个没有中文、没有空格的路径，比如D:\Mingw\mingw64。解压完检查一下D:\Mingw\mingw64\bin里有没有g++.exe、gcc.exe、gdb.exe这三个文件，它们是后面所有配置的主角。
然后把D:\Mingw\mingw64\bin加进系统环境变量 Path。操作是：右键「此电脑」→ 属性 → 高级系统设置 → 环境变量 → 在「系统变量」里找到 Path → 编辑 → 新建 → 粘贴路径 → 一路确定。这里有个坑，很多人点完「编辑」直接把窗口关了，结果没保存。一定要点三次「确定」退出来。验证方式是开一个新的 PowerShell，输入：
g++ --version gdb --version能打印出版本号就说明环境变量生效了。如果提示「不是内部或外部命令」，八成是没开新终端，或者路径写错了。
2.2 TaoToken 统一 Key 是什么，能帮你做什么
TaoToken 提供的是一个统一的 API 通道，你用一把 Key 就能调用多种模型，不用为每个模型单独注册、单独配 Key。对 C++ 开发来说，它主要用在两个地方：一是代码补全，你写到一半的模板、迭代器、智能指针，它能接着补；二是错误诊断，编译报错或者运行时段错误时，把报错贴给它，它能给出定位思路。
适合谁？适合不想在多个平台之间来回切换 Key 的人，也适合想把 AI 能力接进 VS Code 但又不想改一堆配置的人。你需要准备的东西只有两样：一把 API Key，和一个能发请求的插件（后面用 Cline 或 Continue 都行）。
先去控制台创建 Key，地址是https://taotoken.net/api-keys。创建完复制出来，注意它只显示一次。然后记下两个地址：Base URL 用https://taotoken.net/api，模型对话入口在https://taotoken.net/models，接入文档在https://taotoken.net/doc。这三个地址后面配置里会用到。
注意：Key 不要写进会提交到 Git 的文件里。VS Code 的 settings.json 如果放在项目目录下，记得加进 .gitignore。
3. 可复制配置：三个 JSON 文件与 AI 插件 settings
3.1 c_cpp_properties.json：告诉 IntelliSense 头文件在哪
在项目根目录建一个.vscode文件夹，里面新建c_cpp_properties.json。这个文件管的是代码提示和头文件索引，跟编译本身没关系，但配错了会出现「找不到 iostream」的红色波浪线。
{ "configurations": [ { "name": "Win32", "includePath": [ "${workspaceFolder}/**" ], "defines": [ "_DEBUG", "UNICODE", "_UNICODE" ], "compilerPath": "D:/Mingw/mingw64/bin/g++.exe", "cStandard": "c11", "cppStandard": "c++17", "intelliSenseMode": "gcc-x64" } ], "version": 4 }compilerPath改成你自己的g++.exe路径，注意 JSON 里反斜杠要写成正斜杠或者双反斜杠。cppStandard设成c++17，如果你要用c++20的 concepts，就改成c++20，但前提是你的 MinGW-w64 版本够新。
3.2 tasks.json：定义怎么编译
tasks.json管编译。它告诉 VS Code：按哪个命令、带哪些参数、把当前文件编成 exe。
{ "version": "2.0.0", "tasks": [ { "type": "shell", "label": "g++.exe build active file", "command": "D:\\Mingw\\mingw64\\bin\\g++.exe", "args": [ "-g", "-std=c++17", "${file}", "-o", "${fileDirname}\\${fileBasenameNoExtension}.exe" ], "options": { "cwd": "D:\\Mingw\\mingw64\\bin" }, "problemMatcher": [ "$gcc" ], "group": { "kind": "build", "isDefault": true } } ] }label这个名字很重要，launch.json里的preLaunchTask必须跟它一模一样，否则调试时会提示「找不到任务」。-g是生成调试信息，不加这个断点打不上。-std=c++17显式指定标准，避免默认标准太老。
3.3 launch.json：定义怎么启动调试
launch.json管调试器怎么起、程序在哪、gdb 在哪。
{ "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "preLaunchTask": "g++.exe build active file", "type": "cppdbg", "request": "launch", "program": "${fileDirname}\\${fileBasenameNoExtension}.exe", "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": true, "MIMode": "gdb", "miDebuggerPath": "D:/Mingw/mingw64/bin/gdb.exe", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ] } ] }miDebuggerPath指向gdb.exe，别写成g++.exe。externalConsole设成true会弹出一个独立控制台窗口，cin输入不会卡住；设成false就在 VS Code 内置终端里跑，但有时候cin会读不到输入，初学者建议先用true。
3.4 把 TaoToken 接进 AI 补全插件
这里以 Cline 为例，它支持自定义 OpenAI 兼容接口。在 VS Code 扩展市场装好 Cline，打开设置，选 API Provider 为「OpenAI Compatible」，然后填三件套：
| 配置项 | 填写内容 |
|---|---|
| Base URL | https://taotoken.net/api |
| API Key | 你在控制台创建的那把 Key |
| Model ID | 在https://taotoken.net/models里选一个，比如claude-sonnet-4-5这类 |
填完保存，Cline 面板里发一句「用 C++ 写一个线程安全的单例」，能返回代码就说明通道通了。如果你用的是 Continue，配置写在config.json里，结构类似，也是 Base URL + Key + Model ID 三件套。
提示：C++ 补全对模型理解上下文要求高，建议选长上下文模型，把当前文件内容一起带上，补出来的模板参数才准。
4. 验证请求：从编译到断点再到 AI 补全
4.1 先验证编译能过
新建hello.cpp：
#include <iostream> #include <vector> #include <algorithm> int main() { std::vector<int> nums = {5, 2, 8, 1, 9}; std::sort(nums.begin(), nums.end()); for (int n : nums) { std::cout << n << " "; } std::cout << std::endl; return 0; }按Ctrl+Shift+B触发构建任务，终端里应该出现g++.exe的编译命令，没有报错就说明tasks.json生效了。此时目录下会多出一个hello.exe。
4.2 再验证断点调试
在std::sort那一行左侧点一下，出现红点就是断点。按 F5，选择(gdb) Launch。程序会停在断点处，左侧变量面板能看到nums的当前值。按 F10 单步跳过，观察nums从{5,2,8,1,9}变成有序的过程。如果断点是灰色空心圈，说明-g没加或者program路径不对。
4.3 最后验证 AI 补全与诊断
在 Cline 里输入：「下面这段 C++ 代码有内存泄漏，帮我找出来」，然后贴一段new了没delete的代码。它能指出问题并给出std::unique_ptr的改法，就说明 TaoToken 通道和插件都通了。再试一个编译错误：故意把std::vector写成std::vectr，把编译器的报错原文贴给 AI，让它解释error: 'vectr' is not a member of 'std'是什么意思。这一步验证的是「错误诊断」链路。
如果你更偏向长期在 VS Code 里做 C++ 工程，可以考虑 Coding Plan，入口在https://taotoken.net/coding-plan，适合需要持续补全和 Agent 辅助的场景。
5. 本篇常见错排查：401、local proxy failed 与断点失效
5.1 401 Unauthorized
这是 AI 插件侧最常见的报错。原因通常是 Key 填错、Key 过期，或者 Base URL 写成了带路径的地址。检查两点：Base URL 必须是https://taotoken.net/api，不要在后面加/v1或/chat/completions；Key 复制时有没有带空格。改完保存，重启一下 VS Code 再试。
5.2 local proxy failed
这个报错一般出现在插件尝试走本地代理但连不上时。先确认你的网络能正常访问https://taotoken.net/api，可以在浏览器里打开接入文档https://taotoken.net/doc看能不能加载。如果文档能开但插件报 proxy failed，检查插件设置里有没有误开「Use Local Proxy」之类的选项，关掉它，让它直连 Base URL。
5.3 reading 'choices' 报错
这个报错说明请求发出去了，但返回结构里没有choices字段。常见原因是 Model ID 填了一个不存在的模型名。去https://taotoken.net/models复制准确的模型 ID，别自己拼。另一个原因是请求体格式不对，如果你手动改过插件的请求模板，恢复默认再试。
5.4 断点变成灰色空心圈
这不是 AI 的问题，是调试配置的问题。三个检查点：tasks.json里有没有-g；launch.json里program指向的 exe 路径跟tasks.json输出路径是否一致；preLaunchTask的字符串跟tasks.json的label是否完全一致。三者任一不对，断点就不生效。
5.5 gdb 报 “During startup program exited with code”
这种一般是miDebuggerPath写错，或者gdb.exe跟g++.exe不是同一个工具链里的。确认两个 exe 都在D:\Mingw\mingw64\bin下。还有一种情况是程序本身在main之前就崩了，比如全局对象的构造函数里访问了空指针，这时候把stopAtEntry设成true，让它在入口就停下来。
6. 把这条链路固定成你的日常开发流
配置一次，后面就是习惯问题。我的做法是：每个新 C++ 项目，先把.vscode文件夹和三个 JSON 复制进去，改一下compilerPath和miDebuggerPath就能用。AI 插件那边，Key 存在 VS Code 的用户级 settings 里，不放进项目目录，避免误提交。
日常写代码的顺序是：先让 AI 补全把函数骨架搭出来，编译一次看有没有语法错，有错就把报错贴给 AI 让它解释，改完再打断点验证逻辑。这样一轮下来，比纯手写快不少，也比纯靠 AI 写更可控，因为编译器和调试器会帮你兜底。
如果你还没创建 Key，去https://taotoken.net/api-keys建一把；接入细节看https://taotoken.net/doc；想先试试模型对话效果，直接开https://taotoken.net/models。这三个入口够你把整条链路跑通了。
