右下角显示“plain text”说明sublime未绑定.lua后缀到lua语法，需手动点击右下角选“lua”并设置“open all with current extension as… → lua”；若菜单无lua项，则内置语法包损坏。
为什么右下角显示“Plain Text”就说明Lua高亮没生效
这不是插件没装，而是Sublime压根没把 .lua 文件和Lua语法绑定。哪怕你装了 LuaExtended 或 LuaLanguage，只要没手动触发一次语言切换，所有 .lua 文件默认还是走 Plain Text 解析——结果就是关键字不着色、括号不匹配、缩进错乱。
解决方法极简：
- 打开任意一个 .lua 文件
- 点击右下角当前语言标识（比如显示“Plain Text”）
- 从弹出菜单中选 Lua（注意不是 LuaEnhanced 或 LuaLanguage，那是插件名，不是语法名）
- 然后点击 Open all with current extension as… → Lua
之后所有 .lua 文件都会自动识别。如果菜单里根本没有 Lua，说明内置语法包损坏或被覆盖，得重装 Sublime 或手动恢复 Packages/Lua 目录。
怎么让 cc.Node:create() 这类链式调用有补全
纯语法高亮解决不了补全问题。Cocos2d-x 的 Lua API 是动态构造的，标准库补全插件（如 LuaComplete）完全不认识 cc、display、audio 这些模块。
必须上 LSP + lua-language-server，且要告诉服务器这些全局对象在哪：
- 安装 LSP 和 LSP-lua 插件
- 下载官方 lua-language-server（推荐 v3.10+），解压到固定路径，比如 C:\lua-language-server
- 在 Preferences → Package Settings → LSP → Settings 中填入：
{
"clients": {
"lua": {
"command": ["C:/lua-language-server/bin/lua-language-server"],
"scopes": ["source.lua"],
"syntaxes": ["Packages/LuaExtended/Lua.tmLanguage"],
"settings": {
"Lua": {
"workspace.library": [
"D:/cocos2d-x-3.17.2/cocos/scripting/lua-bindings/auto",
"D:/cocos2d-x-3.17.2/cocos/scripting/lua-bindings/manual"
]
}
}
}
}
}其中 workspace.library 路径必须指向你本地 Cocos2d-x 的 auto 和 manual 绑定目录，否则 cc. 开头的提示永远为空。构建系统配好了，但 cocos compile 报 “command not found”
根本原因不是命令写错，而是 Sublime 没继承你的 shell 环境变量。你在终端能跑 cocos，不代表 Sublime 的构建进程也能——它启动的是干净的子进程。
Windows 下必须显式调用 cmd：
{
"cmd": ["cmd", "/c", "cocos", "compile", "-p", "win32"],
"working_dir": "${project_path}",
"shell": true
}macOS/Linux 则必须补全 env 并指定 shell：{
"cmd": ["cocos", "compile", "-p", "ios"],
"working_dir": "${project_path}",
"shell": true,
"env": {
"PATH": "/usr/local/bin:/opt/homebrew/bin:${PATH}"
}
}注意：working_dir 必须设为项目根目录（含 proj.ios_mac 或 frameworks/runtime-src 的那一层），否则 cocos 找不到 build-cfg.json，直接报错退出。Ctrl+Click 跳不到 CCNode.h 怎么办
Sublime 默认只索引当前 project 文件夹里的代码。Cocos2d-x 引擎源码在外部目录，不加声明，它连 cc.Sprite:create() 都不会尝试跳转。
在项目根目录的 .sublime-project 文件里，folders 数组不能只写自己代码路径：
"folders": [
{
"path": "."
},
{
"path": "/path/to/cocos2d-x/cocos"
},
{
"path": "/path/to/cocos2d-x/external"
}
]并且 Cocos2d-x 3.17+ 版本还必须加一句："settings": {
"index_files": true
}否则新增的头文件不会被扫描，跳转依然失效。别图省事把整个 cocos2d-x 目录拖进 Sublime 左侧边栏——索引会卡死，而且干扰 project-specific 设置。
