Sublime配置Cocos2d-js环境 编写游戏脚本教程

Sublime配置Cocos2d-js环境 编写游戏脚本教程

如果你直接用Sublime Text打开Cocos2d-js的.js文件，大概率会遇到一堆烦人的问题：cc.Node:create()没有代码提示、import语句被标红、async/await被当成语法错误……先别急着怀疑自己的代码，这很可能不是你的问题，而是编辑器根本没认出来这是个Cocos2d-js的JSB项目环境。默认状态下，Sublime对这套引擎的语法支持、API跳转和现代Ja vaScript特性识别，几乎是“两眼一抹黑”。

Sublime 怎么识别Cocos2d-js的.js文件为JSB模式

关键在于，Sublime默认把.js文件当作普通的Ja vaScript来处理，它完全不知道cc、cc.sys这些Cocos2d-js特有的全局对象，更别提那些JSB扩展的API了。想让编辑器“开窍”，你得明确告诉它：

• 首先，看一眼Sublime窗口右下角，那里通常显示着“Ja vaScript”。点击它，选择“Open all with current extension as…” → “Ja vaScript (JSB)”。
• 如果下拉列表里压根没有“Ja vaScript (JSB)”这个选项，那就说明缺少对应的语法定义文件。你需要手动找到并下载Ja vaScript (JSB).sublime-syntax文件，然后把它放进Packages/User/目录里。
• 完成绑定后，编辑器才会初步识别JSB语法，这时cc.开头的链式调用才有可能触发基础补全（当然，完整的智能提示还得靠后续的插件配置）。

为什么EasyClangComplete对JSB无效，得换插件

这里有个常见的误区：EasyClangComplete插件是给C++用的，它对JSB的.js文件完全不起作用。要让Cocos2d-js的API提示变得智能，核心依赖两样东西：一是引擎自带的API描述文件（通常是cocos2d-js/api/jsb-api.json），二是一个能读取并索引这个文件的插件。可行的方案主要有两种：

• 安装SublimeCodeIntel插件。这个插件虽然有些年头，但胜在稳定。安装后，需要手动配置它的配置文件（~/.codeintel/config），把jsb-api.json的路径指给它。
• 或者，采用JsPrettier + AutoFileName的组合方案。JsPrettier负责代码格式化，而AutoFileName则能很好地补全资源路径（比如res/目录下的图片名）。
• 特别提醒，尽量避免尝试tern_for_sublime。它依赖Node.js运行时环境，而JSB环境下很多Node API（比如fs）是不可用的，会导致持续不断的ReferenceError: require is not defined报错。

ES6+语法报错（Unexpected token import）怎么修

遇到Unexpected token import或Unexpected token const这类错误，根本原因在于Sublime内置的Ja vaScript语法解析器版本较旧，不认识ES6及以上的现代语法。解决方法不是去升级Sublime本身，而是通过项目配置来覆盖默认的语法定义：

• 在你的Cocos2d-js项目根目录下，创建一个名为.sublime-project的文件。
• 在文件中写入以下配置（注意，JSON的缩进建议使用2个空格）：

{
  "settings": {
    "ja vascript_esnext": true
  }
}

• 保存文件，然后重启Sublime或者重新打开这个项目。之后，import、export、class、async等语法就应该不再被标红了。
• 如果你的项目还使用了Babel进行转译，那么还需要在.sublime-project文件中额外添加"babel_transpile": true这一行设置，并且确保你的本地开发环境已经安装了babel-cli。

cc.*补全失效或跳转不到源码的常见原因

即使前面的语法和插件都配置好了，有时候cc.log还是无法跳转，cc.Sprite依然没有提示。问题通常卡在以下几个环节：

• cc这个对象是游戏运行时才注入的全局变量，Sublime无法通过静态分析找到它。因此，必须依赖jsb-api.json这个符号表文件。请首先检查这个文件是否存在，并且你配置的路径是否正确（它通常位于cocos2d-js/frameworks/cocos2d-html5/cocos2d/目录下）。
• 插件缓存可能“过期”了。可以尝试删除Packages/User/SublimeCodeIntel/cache/目录下的所有缓存文件，然后重启Sublime，强制插件重新索引API。
• 项目结构不标准。如果你的src/源码目录和frameworks/引擎框架目录不在同一层级，SublimeCodeIntel可能默认就找不到API文件。这时需要在它的配置文件里，通过"js_extra_files"设置硬编码指定文件路径列表。
• 在Mac系统上，可能会遇到Python路径问题。Sublime 3.3+版本默认使用内置的Python 3.8，但有些老插件可能仍依赖Python 2.7的json模块。可以临时在Preferences → Settings – User的用户设置里添加一行："pyenv_python_path": "/usr/bin/python2.7"来尝试解决。

最后，也是最容易被忽略的一点：.sublime-project文件必须放在项目的根目录。如果把它错放在Sublime的安装目录或者用户目录下，那么里面所有的设置（包括ja vascript_esnext）都将完全不会生效。这一点务必确认清楚。