1. Cocos Creator 原生平台调试为什么总卡在 launch.json如果你正在用 Cocos Creator 做原生平台Android/iOS开发大概率经历过这个场景编辑器里跑得好好的一按 VS Code 的调试按钮要么连不上模拟器要么报valid project之类的错要么断点全是灰的。问题往往不在你的游戏逻辑而在 VS Code 的launch.json和本地调试服务之间的配置对不上。Cocos Creator 的原生调试链路其实分两段一段是编辑器把脚本打包进模拟器工程另一段是 VS Code 通过调试适配器连上模拟器里的 JS 运行时。launch.json就是第二段的“接头暗号”type、port、address、program任何一个写错断点就命中不了。更麻烦的是很多开发者在调试原生平台的同时还要调 AI 辅助编码、跑 Agent 脚本本地会同时存在多个服务和多个 Key端口和凭证一冲突排查成本直接翻倍。这篇就按“能跟做”的思路把 Cocos Creator 原生平台调试的launch.json骨架、本地服务配置、以及用 TaoToken 统一 Key/API 通道的接入位置讲清楚。适合需要在真机或模拟器上断点调试、又不想在多个 Key 之间来回切换的开发者。核心检索词先摆出来cocos creator 原生平台调试、VS Code launch.json 配置、TaoToken 统一 Key、断点命中验证。我试过把调试服务和 AI 编码通道分开配结果每次换项目都要重新对一遍端口后来统一走一个 API 通道才省心。下面从问题复现开始一步步给可复制的配置。2. 前置TaoToken 统一 Key 与本地调试服务的关系在讲launch.json之前先把“为什么要在 Cocos 调试里提 TaoToken”说清楚。Cocos Creator 原生调试本身不依赖外部 API但现代开发流里你很可能同时开着VS Code 里的 AI 编码插件补全、解释报错本地跑的 Agent 脚本自动生成测试用例、批量改配置调试过程中让模型帮忙读日志、定位valid project这类报错这些工具如果各自配一套 Key 和 Base URL本地就会多出好几个服务端口和凭证文件。调试原生平台时launch.json里的port一旦和这些服务撞车VS Code 就会连到错误的进程上表现就是“断点不生效”或“连接被拒绝”。TaoToken 在这里的角色是统一入口一个 Key、一个 API 地址把模型对话、编码补全、Agent 调用都收口。这样你在 Cocos 项目里只需要维护一份凭证launch.json的端口规划也不会被多个服务搅乱。接入位置分两块模型对话/验证用模型对话页面确认 Key 可用地址是https://taotoken.net/apiAPI 地址不加 UTM。编码/Agent 长期用走 Coding Plan适合需要持续调用、跑批量任务的场景。Key 管理在 API Keys 页面生成和轮换接入文档里有各语言的示例。官网入口统一走https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content后面 CTA 会按场景分流。注意TaoToken 是 API 通道不是编辑器替代品也不做任何网络层绕过。它的作用是让你在合法合规的前提下用一个 Key 管住多个 AI 调用点。3. 可复制配置launch.json 与 config.toml 骨架这一节是全文重点直接给能粘贴的配置。先明确目录结构很多人第一步就打开错了工程。Cocos Creator 原生调试时VS Code 要打开的不是你的项目根目录而是模拟器工程目录。Windows 下典型路径CocosCreator/resources/cocos2d-x/simulator/win32macOS 下对应simulator/mac。打开这个目录后src/project.dev.js是脚本合并后的入口断点下在这里才能命中。3.1 launch.json 骨架在模拟器工程目录下建.vscode/launch.json内容如下。type必须是nodeport要和模拟器调试端口一致address在部分系统上要改成::1{ version: 0.2.0, configurations: [ { name: Cocos Native Debug, type: node, request: attach, port: 5086, address: localhost, restart: true, protocol: inspector, localRoot: ${workspaceFolder}, remoteRoot: ${workspaceFolder}, sourceMaps: false, outFiles: [ ${workspaceFolder}/src/project.dev.js ] } ] }几个参数的作用对照参数作用常见坑type调试器类型写成别的类型直接连不上requestattach 表示附加到已运行进程写成 launch 会尝试自己启动port模拟器调试端口和本地其他服务撞车address连接地址部分系统要改::1outFiles合并后的脚本路径路径错则断点灰3.2 config.toml 骨架如果你在项目里用配置文件管理本地服务比如 AI 编码通道、Agent 脚本建议把 TaoToken 的接入收口到一个config.toml避免散落在多个文件[taotoken] base_url https://taotoken.net/api api_key sk-你的Key timeout 30 [debug] simulator_port 5086 address localhost project_dev src/project.dev.js [coding] plan coding-plan model claude这样launch.json里的port和config.toml里的simulator_port保持同一个值改的时候只改一处。API Key 只在config.toml里出现一次其他脚本读这个文件即可。提示不要把真实 Key 提交到 Git。用环境变量或本地.env覆盖api_key字段。3.3 编辑器侧的准备在 Cocos Creator 编辑器里先运行一次示例程序让模拟器进程起来。然后确认两件事代码编辑环境里Cocos Creator API 适配插件和智能提示数据建议装上虽然不装也能调但装完报错信息更准。模拟器工程目录下的src/project.dev.js存在且是你当前运行的版本。4. 验证请求启动调试、断点命中与成功结果配置写完按下面的顺序验证每一步都有明确的成功标志。第一步在 Cocos Creator 里运行示例程序保持模拟器窗口开着。此时模拟器内部已经启动了调试服务监听在5086。第二步VS Code 打开模拟器工程目录按 F5 或点调试面板的绿色三角。如果launch.json正确底部状态栏会变成橙色表示已附加到进程。第三步在src/project.dev.js里找一个你确定会执行的函数比如场景加载回调打一个断点。触发游戏逻辑后断点应该变红并停住。如果断点是灰色空心圆说明outFiles路径不对或者你打开的不是模拟器工程目录。第四步验证 TaoToken 通道。在终端里用 curl 发一个最小请求确认 Key 和 Base URL 可用curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude, messages: [{role: user, content: ping}] }返回里带choices字段就说明通道正常。这一步和 Cocos 调试是并行的目的是确认你在调试过程中调用的 AI 辅助能力不会因为 Key 问题中断。成功结果长这样VS Code 调试状态栏橙色断点命中后变量面板能展开this和局部变量。模拟器窗口正常渲染不闪退。curl 返回 200choices[0].message.content有内容。如果断点命中但变量是undefined检查sourceMaps是否误开原生调试一般关掉。5. 本篇常见错排查这一节按报错关键词组织遇到哪个查哪个。报valid project或invalid project多半是 VS Code 打开目录错了。确认打开的是simulator/win32或simulator/mac不是项目根目录。另外检查outFiles指向的project.dev.js是否真实存在。报连接不上 /connect ECONNREFUSED模拟器没运行或者port不对。先在编辑器里运行程序再用netstat确认5086在监听。如果端口被占用改launch.json和config.toml里的端口为同一个新值。报不知道节点版本type写错了。必须是nodeprotocol用inspector。有些旧文档写jsb那是老版本现在不适用。断点灰色不命中address试试从localhost改成::1。部分系统上 IPv6 解析更稳。另外确认localRoot和remoteRoot指向同一目录。改了配置没生效VS Code 调试配置有缓存改完launch.json后关掉调试会话重新 F5。config.toml如果被脚本读取重启脚本进程。TaoToken 请求 401Key 错了或过期。去 API Keys 页面重新生成更新config.toml。接入文档里有各语言的鉴权示例对照检查 Header 格式。多个服务端口冲突把 AI 编码通道、Agent 脚本、Cocos 调试端口列一张表确保不重复。TaoToken 统一 Key 后至少凭证层面不会再多出一套。注意排查时优先看 VS Code 的调试控制台输出里面的堆栈比弹窗信息详细得多。6. 按场景分流的接入入口配置和排障都走通后按你的实际用途选入口不要只停在首页。如果你在排障或接入阶段需要生成/轮换 Key、看各语言示例走 API Keys 和接入文档API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你只是想先验证模型能不能用、跑个对话确认通道走模型对话模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你是长期编码、跑 Agent、需要稳定调用额度走 Coding PlanCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台统一在https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentClaude Code 相关接入看https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。最后给一个实用技巧把launch.json和config.toml里的端口写成同一个变量来源比如都用5086改的时候只改一处。调试原生平台最耗时间的不是写逻辑而是配置对不上把配置收口断点命中就是顺带的事。