1. 为什么新手装完 VSCode 还是跑不了 C很多人第一次在 Windows 上装 VSCode以为装完就能写 C 了结果新建一个.cpp文件点运行弹出来的是一堆看不懂的报错或者干脆提示g 不是内部或外部命令。这不是你操作错了而是 VSCode 本身只是个编辑器它不带编译器。真正干活的是 MinGW-w64 里的gVSCode 只是负责调用它。所以完整的链路是这样的MinGW-w64 提供g和gdb把它们的bin目录加进系统 PATHVSCode 通过.vscode文件夹里的三个 JSON 文件知道去哪找编译器、怎么编译、怎么调试。这三步缺一个第一个程序就跑不起来。这篇面向 Windows 新手把安装 VSCode、下载 MinGW-w64、配置 PATH、写tasks.json/launch.json/c_cpp_properties.json、编译验证整条流程走一遍配置文件都可以直接复制改路径。最后再补一段用 TaoToken 的统一 Key 和 API 通道把 AI 补全插件接进 VSCode让写 C 的时候有代码建议不用在多个平台之间来回切 Key。适合谁刚接触 C、在 Windows 上第一次配环境、被 PATH 和 JSON 配置卡住的人。跟着做g -v能出版本号Hello World能跑出结果就算通了。2. 前置准备TaoToken 统一 Key 与 API 通道在配编译器之前先把 AI 补全这条线准备好后面接插件的时候直接用。TaoToken 在这里的作用是你不需要分别去申请多个模型的 Key用同一个 Key 走同一个 API 地址就能在 VSCode 的 AI 插件里调用模型做代码补全和问答。先拿到 Key。打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册登录后进控制台在 API Keys 页面创建一个新 Key复制出来存好。这个 Key 就是后面插件里要填的凭证。API 地址用https://taotoken.net/api注意这个地址不带任何查询参数插件里填 Base URL 的时候直接写它。如果你用的是支持 Anthropic 协议的插件或工具走https://taotoken.net/api对应的 ClaudeCodeAnthropic 通道即可具体在文档里有说明。注意Key 只显示一次创建后立刻复制保存。不要把它写进会提交到 Git 的配置文件里建议放在插件自己的设置界面或本地环境变量中。这一步做完你手里应该有一个可用的 Key 和一个 API 地址。编译器那边还没动但 AI 补全的通道已经通了后面配完 C 环境直接接上就行。3. 安装 VSCode 与 MinGW-w64把 g 加进 PATH3.1 装 VSCode去 VSCode 官网下载 Windows 版安装包右键以管理员身份运行。勾选同意协议下一步安装位置可以自定义建议不要放在 C 盘根目录以外太深的地方继续下一步到「选择附加任务」这一页把「添加到 PATH」和「创建桌面快捷方式」都勾上这两个对后面命令行调用很重要。点安装完成后启动。第一次打开是英文界面点左侧扩展按钮搜索chinese安装中文语言包点 restart 重启界面就变中文了。3.2 下载 MinGW-w64MinGW-w64 是 Windows 上的 GCC 工具链提供g、gcc、gdb。去 MinGW-w64 的下载页找到x86_64-posix-sjlj这个版本下载。下载下来是个压缩包解压到你打算放工具链的位置比如D:\mingw64。解压完确认一下D:\mingw64\bin目录下有g.exe、gcc.exe、gdb.exe这几个文件。3.3 把 bin 目录加进系统 PATH右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。在「系统变量」里找到Path双击点「新建」把D:\mingw64\bin粘贴进去确定、确定、确定一路关掉。验证按Win R输入cmd回车在命令行里敲g -v如果输出里出现gcc version和版本号说明 PATH 配好了。如果提示「不是内部或外部命令」说明路径没加对回去检查Path里是不是真的写成了D:\mingw64\bin注意不要写成D:\mingw64\bin\带尾部反斜杠有时候也会出问题去掉尾部斜杠再试。4. 可复制配置tasks.json、launch.json、c_cpp_properties.json4.1 建工作区和 .vscode 目录在 VSCode 里点「文件」→「打开文件夹」新建一个文件夹比如D:\cpp_workspace选中它打开。在左侧资源管理器里在这个文件夹下新建一个.vscode文件夹再在里面新建三个文件tasks.json、launch.json、c_cpp_properties.json。同时再建一个src文件夹放源码。4.2 c_cpp_properties.json这个文件告诉 VSCode 的 IntelliSense 去哪找头文件、用哪个编译器。把compilerPath改成你自己的g.exe路径注意 JSON 里反斜杠要写成两个{ configurations: [ { name: Win32, includePath: [${workspaceFolder}/**], defines: [_DEBUG, UNICODE, _UNICODE], windowsSdkVersion: 10.0.17763.0, compilerPath: D:\\mingw64\\bin\\g.exe, cStandard: c11, cppStandard: c17, intelliSenseMode: ${default} } ], version: 4 }4.3 tasks.json这个文件定义编译任务。command指向g.exeargs里-g生成调试信息-stdc17指定标准-o指定输出 exe。options.cwd设成 bin 目录保证编译时能找到依赖{ version: 2.0.0, tasks: [ { type: shell, label: task g, command: D:\\mingw64\\bin\\g.exe, args: [ -g, ${file}, -o, ${fileDirname}\\${fileBasenameNoExtension}.exe, -stdc17 ], options: { cwd: D:\\mingw64\\bin }, problemMatcher: [$gcc], group: build } ] }4.4 launch.json这个文件定义调试配置。miDebuggerPath指向gdb.exepreLaunchTask要和tasks.json里的label一致都是task g这样按 F5 调试时会先编译再启动调试{ version: 0.2.0, configurations: [ { name: g.exe build and debug active file, type: cppdbg, request: launch, program: ${fileDirname}\\${fileBasenameNoExtension}.exe, args: [], stopAtEntry: false, cwd: ${workspaceFolder}, environment: [], externalConsole: true, MIMode: gdb, miDebuggerPath: D:\\mingw64\\bin\\gdb.exe, setupCommands: [ { description: 为 gdb 启用整齐打印, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: task g } ] }三个文件里的路径都要改成你自己机器上的实际路径反斜杠写成双反斜杠。改完保存。5. 验证请求编译并运行第一个 C 程序在src文件夹下新建demo.cpp写入#include stdio.h #include windows.h int main() { printf(Hello World\n); system(pause); return 0; }保存后点 VSCode 左侧的「运行和调试」按钮或者直接按 F5。第一次会弹出选择调试配置选g.exe build and debug active file。如果配置正确会先执行task g编译然后弹出外部控制台窗口显示Hello World按任意键继续。如果不想用调试也可以在终端里手动验证。打开 VSCode 终端切到源码目录敲g -g demo.cpp -o demo.exe -stdc17 .\demo.exe能输出Hello World就说明g工具链和 VSCode 配置都通了。5.1 接入 TaoToken 做 AI 补全C 环境跑通后在 VSCode 扩展市场搜索支持自定义 API 的 AI 补全插件安装后在插件设置里填两样东西API Key 填你在第 2 步创建的 TaoToken KeyBase URL 填https://taotoken.net/api。保存后新建一个.cpp文件输入#include或者写一个函数名插件会通过 TaoToken 的通道请求模型返回补全建议。如果你更习惯在对话里问代码问题可以直接用模型对话入口把报错信息贴进去让它帮你分析。长期写 C 项目、需要 Agent 辅助改代码的可以看 Coding Plan把 Key 和通道配好之后补全和问答走同一条线不用来回换。6. 本篇常见错排查g 不是内部或外部命令PATH 没生效。关掉所有 cmd 和 VSCode 窗口重新开或者检查Path里是不是写成了D:\mingw64\bin不要带尾部反斜杠也不要写成D:\mingw64少了 bin。tasks.json 报错找不到 gcommand路径写错了或者反斜杠只写了一个。JSON 里必须用\\。确认D:\mingw64\bin\g.exe这个文件真实存在。launch.json 里 preLaunchTask 不匹配preLaunchTask的值必须和tasks.json里某个 task 的label完全一致大小写敏感。这里两边都是task g。调试时弹不出外部控制台externalConsole设为true才会弹独立窗口。如果设成false输出会在 VSCode 内置终端里system(pause)可能看不到效果。IntelliSense 报红但能编译c_cpp_properties.json里的compilerPath没配对或者includePath没包含工作区。把compilerPath改成实际的g.exe路径includePath保留${workspaceFolder}/**。改了配置不生效VSCode 有时候会缓存按Ctrl Shift P输入Reload Window重载一下窗口再试。排障过程中如果涉及 API 接入的问题比如插件填了 Key 但请求失败去 TaoToken 的 API Keys 页面确认 Key 状态再看接入文档核对 Base URL 和请求格式。模型本身的行为可以用模型对话单独验证确认是插件配置问题还是通道问题。配好之后这套环境可以一直用。后面换项目只要把.vscode三个文件复制过去改一下路径就能跑。AI 补全那条线Key 和 API 地址填一次插件里就固定了写 C 的时候补全和问答都在同一个窗口里完成。