vscode中cc报红、跳转失败是typescript类型服务未正确接入所致,需确保项目根目录有含"types": ["cocos"]的tsconfig.json,用open folder打开完整项目,并在cocos creator中执行“更新vs code智能提示数据”生成creator.d.ts。

VSCode 本身不运行 Cocos 项目,它只负责编辑和调试——真正运行靠的是 Cocos Creator 编辑器或原生构建流程。配置不到位,连 cc.Node 都报红,写完代码根本不敢保存。
为什么 VSCode 打开脚本后 cc 报红、跳转失败
这不是引擎问题,是 TypeScript 类型服务没接上。常见现象包括:Cannot find namespace 'cc'、_decorator 下划线报错、Ctrl+点击 cc 跳不到定义。
- 确认项目根目录(含
assets和project.json)下存在tsconfig.json,且里面包含"types": ["cocos"]或已声明cocos类型路径 - 必须用 VSCode 的 File → Open Folder 打开整个项目文件夹,不能双击单个
.ts文件打开 - 按
Ctrl+Shift+P输入Developer: Reload Window强制重载 TS 服务 - 如果仍无效,在 Cocos Creator 中执行 开发者 → VS Code 工作流 → 更新 VS Code 智能提示数据,生成或刷新
creator.d.ts
VSCode 调试 JSB(原生平台)时断点不生效
模拟器或真机上 JSB 代码跑起来了,但 VSCode 里打的断点完全不触发,多半是路径没对上、调试器没连对、或者 project.dev.js 没被加载。
- 先在 Cocos Creator 编辑器中选择预览平台为 模拟器(调试),再点运行
- 找到模拟器资源路径:
Windows 是CocosCreator/resources/cocos2d-x/simulator/win32
Mac 是CocosCreator.app/Contents/Resources/cocos2d-x/simulator/mac/Simulator.app/Contents/Resources,需拖进 VSCode(不能用“打开文件夹”对话框选 .app 内部) - 在打开的路径中定位到
src/project.dev.js,设断点;确保模拟器已启动并加载了你的项目 - VSCode 左侧 Debug 面板选择
Cocos-JSB启动配置,点击绿色三角开始调试
如何避免 .meta、library/ 干扰 VSCode 搜索和性能
VSCode 默认索引全部文件,Cocos 自动生成的 .meta、library/、build/ 会拖慢 Ctrl+P、占用内存、甚至让 TS 语言服务卡死。
- 在项目根目录的
.vscode/settings.json中添加:"files.exclude": { "**/.meta": true, "**/library": true, "**/build": true, "**/temp": true } - 同时在
tsconfig.json的exclude字段里加上这些路径,防止 TS 服务扫描它们 - 不要手动删除
.meta文件——那是 Cocos 的资源映射依据,删了会导致资源丢失或引用错乱
creator.d.ts 生成后不会自动更新,换引擎版本、切自定义引擎、甚至升级 Creator 小版本,都得手动再跑一次 更新 VS Code 智能提示数据——这点最容易被忽略,等报错才回头补,耽误半天。











