必须满足三个硬性条件：项目根目录有含"types": ["cocos"]的tsconfig.json、用vscode通过file→open folder打开整个项目文件夹（非单个文件）、执行过“开发者→vs code工作流→更新vs code智能提示数据”生成creator.d.ts，缺一则cc报红、跳转失效、@ccclass不识别。
VSCode 要识别 Cocos Creator 的 TypeScript 类型，必须满足三个硬性条件：项目根目录有有效的 tsconfig.json、用 VSCode 打开整个项目文件夹（不是单个文件）、执行过“更新 VS Code 智能提示数据”——缺一不可，否则 cc 报红、跳转失效、@ccclass 不识别全是必然结果。
为什么 cc.Node 一直报红，“Cannot find namespace 'cc'”
这不是类型定义没装，而是 VSCode 根本没加载到引擎类型上下文。常见原因有：
- 用 VSCode 直接双击打开了某个
.ts文件，而不是通过 File → Open Folder 打开项目根目录（即含project.json和assets的那个文件夹） -
tsconfig.json被手动删改过，缺失了"types": ["cocos"]或指向引擎声明的"typeRoots" - 项目是手动新建的空文件夹，不是通过 Cocos Creator “新建项目”创建的——这种项目不会自动生成合规的
tsconfig.json
实操建议：
确认 tsconfig.json 存在且未被破坏；按 Ctrl+Shift+P 输入 Developer: Reload Window 强制重载 TS 服务；若仍无效，立刻去 Cocos Creator 菜单执行 开发者 → VS Code 工作流 → 更新 VS Code 智能提示数据，它会生成或覆盖项目根目录下的 creator.d.ts。
“更新 VS Code 智能提示数据”到底做了什么
这个操作本质是把当前 Cocos Creator 引擎版本的完整 API 声明导出为一个标准的 creator.d.ts 文件，并放在项目根目录（assets 同级）。VSCode 的 TypeScript 语言服务靠它提供补全、跳转和类型检查。
- 每次升级 Cocos Creator 版本后，必须重新执行一次——旧版
creator.d.ts不兼容新版引擎 API - 不同项目之间不共享该文件，每个项目都要单独生成
- 生成后无需手动修改
tsconfig.json，只要它保留"types": ["cocos"]就能自动识别creator.d.ts
注意：creator.d.ts 是只读的，不要把它加进 Git 提交，但也不要 .gitignore 掉——它属于项目运行必需的类型基础设施。
VSCode 插件要不要装、装在哪
Cocos Creator 自带的“安装 VS Code 扩展插件”功能，实际是把 cocos-debug 和语法提示辅助插件复制到 VSCode 全局扩展目录（如 ~/.vscode/extensions/），不是装在项目里。
- 只需执行一次，除非插件本身更新了才需要重装
- 装完后重启 VSCode，左侧调试栏会出现
Cocos-JSB配置项，用于原生平台断点调试 - 它不影响 TypeScript 类型识别，类型识别完全依赖
tsconfig.json+creator.d.ts，和插件无关
如果你只是写 Web 版脚本，不调试 Android/iOS，这个插件可装可不装；但一旦要连真机调试 JSB，没它就无法设断点。
怎么排除 .meta 和 library/ 干扰
VSCode 默认索引全部文件，而 Cocos Creator 的 .meta、library/、build/ 既不参与编译，又含大量二进制内容，会导致：
-
Ctrl+P搜索卡顿甚至无响应 - TypeScript 语言服务内存占用飙升、频繁崩溃
- 误跳转到
.meta对应的临时声明文件
实操建议：在项目根目录建 .vscode/settings.json，加入以下内容：
{
"files.exclude": {
"**/.meta": true,
"**/library": true,
"**/build": true,
"**/temp": true
},
"search.exclude": {
"**/.meta": true,
"**/library": true,
"**/build": true
}
}
这比全局设置更精准，且不会影响其他项目。别用 files.watcherExclude——它对 TS 服务无效。
最常被忽略的一点：所有配置都依赖“项目根目录”这个前提。如果你打开的是 assets 子文件夹，或者路径里有中文/空格，前面所有步骤都会静默失败——VSCode 不报错，但就是不工作。
