1. Ubuntu 下 VS Code 写 C/C++ 到底卡在哪：编译能过、调试断点不生效的完整链路
如果你刚在 Ubuntu 上装好 VS Code，搜到最多的教程就是「装个 C/C++ 插件、装个 Code Runner，点三角形就能跑」。照着做确实能跑出 Hello World，但接下来大概率会遇到三种情况：一是点运行没反应，终端里啥也不输出；二是能跑但断点打上去是空心灰圈，程序直接跑完；三是换了个文件夹，之前配好的调试又失效了。这些问题的根子不在插件，而在于 VS Code 本身不是 IDE，它把「编译」和「调试」拆成了两条独立链路，分别由 tasks.json 和 launch.json 描述，插件只负责把这两条链路接起来。
这篇就按「编译器 → IntelliSense → tasks.json 编译 → launch.json 调试 → AI 补全统一 Key」的顺序，把 Ubuntu 下这套环境从零搭到能用，每一步都给可复制的配置和验证动作。适合刚接触 Linux 开发、或者从 Windows 的 Visual Studio 转过来、被 .vscode 目录搞晕的人。核心检索词就三个：Ubuntu、VS Code、C/C++ 环境配置，全文围绕它们展开，不绕弯。
先说清楚这套链路的分工。gcc/g++ 是真正的编译器，负责把 .cpp 变成可执行文件；gdb 是调试器，负责让程序停下来、看变量；VS Code 的 C/C++ 插件提供 IntelliSense（补全、跳转、报错提示）；tasks.json 告诉 VS Code「怎么调用 g++ 编译」；launch.json 告诉 VS Code「怎么调用 gdb 启动调试」。Code Runner 插件只是帮你省掉手动敲命令，它不参与调试，所以只装 Code Runner 是永远调不了断点的。理解这一点，后面所有配置都是顺理成章。
我试过在一台干净的 Ubuntu 22.04 上从零走一遍，全程大概十五分钟，其中大部分时间花在等 apt 下载。下面每一步都标注了验证命令，你做完一步就能确认这步是否真的生效，而不是攒到最后一起报错再回头找。
2. 装编译器、插件与 TaoToken 统一 Key 的前置准备
2.1 安装 gcc、g++、gdb 并验证版本
打开终端，先更新索引再装三个包。这里不要图省事只装 gcc，C++ 需要 g++，调试需要 gdb，三个都要。
sudo apt-get update sudo apt-get install -y gcc g++ gdb build-essential装完立刻验证，三个命令都要有输出且版本号正常：
gcc -v g++ -v gdb -v如果gdb -v提示 command not found，说明 gdb 没装上，单独再跑一次sudo apt-get install -y gdb。build-essential是个元包，会把 make、libc 开发头文件一起带上，后面编译稍复杂的项目不会缺东西。
2.2 安装 VS Code 与 C/C++ 插件
Ubuntu 应用商店里能搜到 Visual Studio Code，点安装即可；也可以用官方 deb 包安装。装完后在终端输入code能拉起窗口，说明 PATH 配好了。如果提示找不到 code 命令，重启一次终端或者重新登录。
插件只装两个就够起步：C/C++（微软官方，提供 IntelliSense 和调试支持）和Code Runner（可选，快速跑单文件）。装完插件后，VS Code 右下角会提示 reload，点一下重启窗口。
2.3 把 AI 补全的 endpoint 和 Key 统一到 TaoToken
现在写代码基本都会开 AI 补全，但很多工具默认走各自的官方 endpoint，Key 分散、额度分散、切换模型还要改配置。我的做法是把所有 AI 辅助编码工具的 Base URL 和 API Key 统一指向 TaoToken，这样一套 Key 管所有工具，换模型只改一个 Model ID。
TaoToken 官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api （这个不加 UTM）。先去控制台建一个 Key，路径是 console 页面下的 api-keys。
拿到 Key 之后，无论你用的是 Cline、Continue 还是 Claude Code，配置三件套都是固定的：Base URL、API Key、Model ID。以 Cline 为例，在 VS Code 设置里找到 Cline 的 API Provider，选 OpenAI Compatible，然后填：
{ "apiProvider": "openai", "openAiBaseUrl": "https://taotoken.net/api", "openAiApiKey": "sk-你的TaoTokenKey", "openAiModelId": "claude-sonnet-4-5" }Model ID 按你实际要用的模型填，控制台里有可选列表。填完保存，Cline 面板里发一句「用 C++ 写一个快排」测试，能正常返回就说明 Key 通了。这一步做完，后面写 C/C++ 时补全和问答都走这一套，不用再到处找 Key。
3. 可复制的 tasks.json 与 launch.json 配置片段
3.1 目录结构与 .vscode 的位置
先建一个专门放代码的文件夹，比如~/CAndC++Code，用 VS Code 打开这个文件夹（注意是打开文件夹，不是打开单个文件）。然后在文件夹根目录下新建.vscode子目录，里面放两个文件：tasks.json和launch.json。
这里有个高频坑：.vscode必须和你的源码在同一层，或者在其父层。如果你打开的是~/CAndC++Code，源码在~/CAndC++Code/test.cpp，那.vscode就在~/CAndC++Code/.vscode。换文件夹调试时要重新建，因为${workspaceFolder}是按你打开的文件夹算的。
3.2 tasks.json：定义编译任务
把下面内容完整复制进tasks.json。这个任务用 g++ 编译当前打开的源文件，输出到同目录下同名的可执行文件，并带上-g生成调试符号（没有-g，gdb 断点就是灰的）。
{ "version": "2.0.0", "tasks": [ { "label": "compile", "command": "g++", "args": [ "-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}" ], "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 } } ] }几个关键点：label叫compile，这个名字要和 launch.json 里的preLaunchTask完全一致，大小写都不能差。command是g++，如果你写的是纯 C 代码，把它改成gcc。-g必须保留。problemMatcher负责把编译器的报错解析成 VS Code 能识别的波浪线，正则里的warning|error对应严重级别。
3.3 launch.json：定义调试配置
把下面内容复制进launch.json：
{ "version": "0.2.0", "configurations": [ { "name": "C/C++", "type": "cppdbg", "request": "launch", "program": "${fileDirname}/${fileBasenameNoExtension}", "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": false, "MIMode": "gdb", "preLaunchTask": "compile", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ] } ] }program指向编译产物，和 tasks.json 的输出路径必须一致，否则会报「找不到可执行文件」。preLaunchTask填compile，这样按 F5 时会先自动编译再启动调试。MIMode是gdb，对应你装的 gdb。externalConsole设 false，输出走 VS Code 内置终端，方便看。
3.4 用 settings.json 固定 IntelliSense 的编译器路径
如果 IntelliSense 报「找不到头文件」或者补全不准，在.vscode/settings.json里指定编译器路径：
{ "C_Cpp.default.compilerPath": "/usr/bin/g++", "C_Cpp.default.cppStandard": "c++17", "C_Cpp.default.cStandard": "c11" }compilerPath用which g++确认，通常是/usr/bin/g++。标准按你项目需要填，c++17 是现在比较通用的选择。
4. 验证请求：从编译到断点命中的完整动作
4.1 写一个带循环的测试程序
新建test.cpp，写一段有循环、有变量、方便打断点的代码：
#include <iostream> #include <vector> int main() { std::vector<int> nums = {3, 1, 4, 1, 5, 9, 2, 6}; int sum = 0; for (int i = 0; i < nums.size(); ++i) { sum += nums[i]; std::cout << "i=" << i << " num=" << nums[i] << " sum=" << sum << std::endl; } std::cout << "total=" << sum << std::endl; return 0; }4.2 先验证编译任务
按Ctrl+Shift+B触发默认构建任务，也就是 tasks.json 里isDefault: true的那个。终端会输出编译命令，没有报错的话，同目录下会出现一个test可执行文件。在终端手动跑一下：
./test能看到逐行输出和 total，说明编译链路通了。如果这一步就报错，先别往下走，去看第 5 节的编译类报错。
4.3 再验证调试链路
在sum += nums[i];这一行左侧点一下，打一个红点断点。然后按 F5，或者点左侧调试图标的绿色箭头。程序会先自动编译，然后停在断点处，此时左侧变量区能看到i、sum、nums的值。按 F10 单步跳过，观察sum累加；按 F5 继续到下一个断点或结束。
如果断点是空心灰圈、程序直接跑完，说明-g没生效或者program路径不对，回到第 3 节检查。如果弹出「找不到任务 compile」，说明 tasks.json 的 label 和 launch.json 的 preLaunchTask 不一致。
4.4 验证 AI 补全走 TaoToken
在test.cpp里新起一行，输入// 用二分查找，看 Cline 或 Continue 是否给出补全建议。能出建议且不报 401，说明第 2.3 节的 Key 配置生效。如果报错，对照第 5 节的鉴权类报错处理。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth
5.1 编译类：g++ 找不到、-g 缺失、路径不对
报错g++: command not found，说明编译器没装或 PATH 没生效，重跑sudo apt-get install -y g++，再用which g++确认。报错No such file or directory且指向program路径，多半是 tasks.json 的输出路径和 launch.json 的 program 不一致，检查两处的${fileDirname}/${fileBasenameNoExtension}是否完全相同。断点是灰圈，九成是编译时没带-g，检查 tasks.json 的 args 里有没有-g。
5.2 鉴权类：401 与 OAuth 报错
AI 工具报401 Unauthorized，先确认 Key 有没有复制全、有没有多余空格。TaoToken 的 Key 在 console 的 api-keys 页面生成，Base URL 填https://taotoken.net/api，注意不要漏掉/api，也不要多加斜杠。如果工具走的是 OAuth 流程（比如某些 Claude Code 场景），需要改用 API Key 模式，在配置里把认证方式从 OAuth 切到 API Key，填三件套。
5.3 网络类：local proxy failed
报local proxy failed或连接超时，先确认本机网络能正常访问外网，再确认 Base URL 拼写正确。有些工具会读系统代理设置，如果你本机没配代理却开了代理开关，就会报这个。把工具的代理开关关掉，直连https://taotoken.net/api再试。注意这里说的是工具自身的代理配置项，不是让你去搭什么网络通道，纯粹是配置项开关问题。
5.4 响应解析类：reading choices 报错
报error reading choices或返回体解析失败，通常是 Model ID 填错了，或者该模型不支持当前调用格式。去控制台确认 Model ID 拼写，换成列表里明确支持的模型再试。如果换了模型还报，检查请求体里stream参数和工具是否匹配，有些工具默认开流式，而某些模型 ID 不支持流式，关掉流式再试。
5.5 调试类：断点不命中、变量显示 optimized out
断点不命中除了-g问题，还可能是编译优化把变量优化掉了。tasks.json 里不要加-O2之类的优化参数，调试阶段保持无优化。如果变量显示<optimized out>，同样是优化导致，去掉优化参数重新编译即可。
6. 长期写 C/C++ 与 Agent 协作的 Key 管理建议
环境搭好只是开始，真正长期写代码时，Key 和 endpoint 的管理比配置本身更影响效率。我的习惯是：所有 AI 辅助编码工具统一走 TaoToken 的 Base URL，Key 只存一份在密码管理器里，换工具时直接复制。这样不管你是用 Cline 做补全、用 Claude Code 做重构，还是用 Continue 做行内建议，都不用重新申请和配置。
如果你主要做长期编码和 Agent 类任务，比如让 AI 帮你读整个项目、批量改文件、跑测试，可以了解下 Coding Plan，入口在 https://taotoken.net/api 对应的控制台里能找到。日常只是补全和问答，用模型对话页面测试模型是否可用就够了，地址是 https://taotoken.net/api 同域下的对话入口。接入文档在 doc 页面，里面有各工具的详细配置示例，遇到不确定的字段先去那里对一遍。
最后给一个实用技巧：把.vscode目录做成模板，新建项目时直接复制过去，只改 tasks.json 里的command（gcc 还是 g++）和标准版本。这样每开一个新文件夹不用从零配，调试链路一次配好到处复用。编译、调试、AI 补全三条链路各自独立又互相配合，任何一条出问题，按第 5 节对照报错定位，基本都能自己解决。
