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 没被加载。

小游戏开发专家

专业游戏架构师，将用户抽象需求转化为完整可玩的2D/3D小游戏；支持游戏闭环设计、状态管理、碰撞检测、粒子特效；当你需要做游戏、开发网页游戏、学习游戏编程或需要代码调试修复时使用

下载

• 先在 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 的资源映射依据，删了会导致资源丢失或引用错乱

Cocos Creator 的类型系统依赖项目结构和引擎版本强绑定，creator.d.ts 生成后不会自动更新，换引擎版本、切自定义引擎、甚至升级 Creator 小版本，都得手动再跑一次 更新 VS Code 智能提示数据——这点最容易被忽略，等报错才回头补，耽误半天。