sublime text 本身不运行或调试 cocos2d-js 脚本，仅作为编辑器；正确识别并高亮需手动将 .js 文件绑定为 javascript (babel) 或安装 javascript enhancements 插件，配合 build system 一键触发 cocos compile 和浏览器刷新，同时确保资源路径、构建目录与服务根目录一致。
Sublime Text 本身不运行或调试 cocos2d-js 脚本，它只是编辑器；真正执行和调试靠的是浏览器（Web）或 cocos run -p web 启动的本地服务。装完 Sublime Text 后，关键动作是配好语法高亮、快捷键、以及能快速触发构建/预览的命令——不是“让 Sublime 运行 JS”，而是让它无缝对接开发流。
怎么让 Sublime Text 正确识别并高亮 cocos2d-js 的 .js 文件
默认 Sublime Text 对 .js 文件用的是通用 JavaScript 语法，但 cocos2d-js 项目里常混用引擎特有 API（如 cc.Scene、cc.Layer），通用语法不报错也不提示。你需要手动指定语法方案：
- 打开任意一个
.js文件 → 右下角点击当前语法名（比如 “JavaScript”）→ 选 “Open all with current extension as…” → 再选 “JavaScript (Babel)” 或 “JSX+React”（更兼容 ES6+ 类写法） - 或者直接安装
JavaScript Enhancements插件（通过 Package Control），它会自动补全cc、cc.sys等全局对象 - 避免用 “C++” 或 “Lua” 语法强行套用在
.js文件上——会导致括号匹配错乱、缩进异常
为什么 cocos run -p web 启动后页面空白或报 cc is not defined
这是最常见卡点：你改了代码，刷新页面却没生效，甚至控制台直接报 cc is not defined。根本原因不是 Sublime 编辑问题，而是资源加载路径或构建产物没更新：
-
cocos run -p web默认走的是web/bin目录下的构建结果，不是你源码目录里的src/——改完src/app.js必须先cocos compile -p web，再cocos run -p web - 检查
web/index.html中是否引用了正确的 JS 入口，比如：<script src="src/project.js"></script>，而不是main.js或拼错路径 - 浏览器缓存极顽固：启动时加
--port 8080 --live-reload（cocos v3.10+ 支持），或手动清空 DevTools → Application → Clear storage
Sublime Text 怎么一键触发 cocos compile 和刷新浏览器
不用切终端，用 Sublime 的 Build System 就能绑定命令。但注意：macOS/Linux 下需确保 cocos 命令在 $PATH 中可用（即 which cocos 有输出）：
- Tools → Build System → New Build System…，粘贴以下内容并保存为
CocosJS.sublime-build：
{
"shell_cmd": "cd $project_path && cocos compile -p web && open http://localhost:7777",
"working_dir": "$project_path",
"variants": [
{
"name": "Run",
"shell_cmd": "cd $project_path && cocos run -p web"
}
]
}
然后按 Cmd+B（macOS）或 Ctrl+B（Win/Linux）就能编译+打开；Cmd+Shift+B 弹出菜单选 “Run” 就直接启动服务。
- 如果报
command not found: cocos，说明 Sublime 的 shell 环境没加载你的~/.bash_profile或~/.zshrc——可在 Build System 里显式指定 shell："shell": "/bin/zsh" - Windows 用户把
open换成start，路径分隔符用\，且确保cocos是全局命令（即已加到系统 Path）
真正容易被忽略的，是 cocos compile 输出目录和 cocos run 服务根目录是否一致——很多人改了 project.json 里的 outputDir 却忘了同步改 web/index.html 的 script 路径，结果白编译一场。
