VSCode调试Cocos Creator需配置文件排除、调试服务、自动编译及类型声明：在Files: Exclude加*/.meta等，在Search: Exclude加build/等；Cocos中开启调试器并运行；安装Cocos Creator Devtools插件并配置端口；确保tsconfig.json含"types": ["cocos"]且用Open Folder打开项目根目录。
Ctrl+P 搜索只匹配你写的源码，不是整个项目
VSCode 默认会把 .meta、library/、build/ 全部索引进来，结果是你 Ctrl+P 搜 onLoad，出来一堆 Button.js.meta 或 scene.anim，根本找不到自己写的脚本。
实操建议：
- 打开 VSCode 设置（
Ctrl+,），搜exclude - 在
Files: Exclude里加：**/*.meta、library/、temp/、local/ - 在
Search: Exclude里加：build/、**/node_modules、**/*.anim - 改完后重启窗口（
Ctrl+Shift+P→Developer: Reload Window）
F5 调试前必须确认 Cocos Creator 已开启调试服务
按 F5 启动调试却报错 Cannot connect to runtime process，大概率是 Cocos Creator 没开 Chrome Debug 服务，或者端口被占。VSCode 本身不运行游戏，它只是把断点发给 Cocos Creator 的内置 Chromium 实例。
实操建议：
- Cocos Creator 编辑器中：菜单栏 →
项目→构建发布→ 确保平台选web-mobile或web-desktop，勾选开启调试器 - 再点
运行按钮（不是预览），等浏览器弹出且地址栏显示localhost:7456类似端口 - VSCode 中按
F5，首次会提示选择环境，选Cocos Launch Chrome - 如果断点灰色不生效，检查脚本是否已挂载到节点、
@ccclass是否漏写、方法名是否大小写完全一致
Ctrl+S 保存即编译，不用切回编辑器点刷新
每次改完代码都要手动切到 Cocos Creator 点“刷新”太打断节奏。VSCode 可以监听保存事件，自动触发 Cocos Creator 的编译流程，前提是插件和服务端口对得上。
实操建议：
- 安装插件：
Cocos Creator Devtools（通过 VSCode 扩展商店搜索安装） - 项目根目录创建
.vscode/settings.json，内容为：{ "cocos.creator.devtools.port": 7456, "cocos.creator.devtools.save": true } - 确认 Cocos Creator 编辑器已开启服务：菜单栏 →
开发者→启动调试服务器（端口号需与配置一致） - 保存
.ts文件时，状态栏右下角会出现Compiling...提示，几秒后自动热更新
Ctrl+Click 跳转 cc.Node 失败？不是代码问题，是类型没加载
cc.Node 报红、import { _decorator } from 'cc' 下划线标黄、Ctrl+Click 跳不到定义——这些都不是你写错了，而是 TypeScript 语言服务压根没识别 Cocos 引擎的类型声明。
实操建议：
- 确认项目根目录（含
project.json和assets的目录）存在tsconfig.json，且含"types": ["cocos"] - 必须用
File → Open Folder…打开整个项目根目录，不能双击单个.ts文件打开 - 执行
Ctrl+Shift+P→ 输入Developer: Reload Window - 若仍无效，在 Cocos Creator 中执行：
开发者 → VS Code 工作流 → 更新 VS Code 智能提示数据，生成或刷新creator.d.ts
真正卡住人的地方往往不是语法，而是 VSCode 没真正“看见”Cocos 的类型系统；跳转失效、智能提示飘红、保存不编译，背后全是路径、端口、配置项之间差了一个字符或一个斜杠的事。
