language-lua插件仅提供语法高亮，不支持运行或补全；若.lua文件全灰，说明未安装或未生效，需通过settings→install搜索安装，成功后print变蓝、字符串变红即生效。
language-lua 插件只负责语法高亮，不运行也不补全
打开 .lua 文件后全是灰色文本？说明 language-lua 没装或没生效。它只做两件事：识别 if、function 等关键字并着色，匹配括号和字符串引号。不提供 Ctrl+Space 补全，也不响应 F9 运行。
安装方式很简单：Settings → Install 搜索 language-lua，点 Install。装完新建 test.lua，写 print("ok") —— 如果 print 变蓝、字符串变红，就说明成功了。
注意：language-lua 不认识 PICO-8 的 _update 或 _draw，这类项目得换 language-pico8；如果是 LuaJIT 项目（用了 ffi.cdef 或 #!jit），则必须用 atom-language-luajit，否则 FFI 类型声明会乱色甚至错解析。
atom-build.yml 是运行 Lua 的唯一入口
按 F9 没反应？不是快捷键问题，是根本没配置构建命令。Atom 默认不认识 .lua，必须靠 atom-build 插件 + atom-build.yml 文件联动解释器。
在项目根目录（或 ~/.atom/）新建文件 atom-build.yml，内容严格如下（YAML 对缩进敏感，必须用空格，不能用 Tab）：
cmd: "lua"
name: "lua"
args: ["{FILE_ACTIVE}"]
cwd: "{FILE_ACTIVE_PATH}"
关键点：
-
cmd值必须是可执行命令名，比如你装的是luajit，就得写cmd: "luajit" -
{FILE_ACTIVE}和{FILE_ACTIVE_PATH}是 Atom 内置变量，别加引号、别手误写成$FILE_ACTIVE - 如果 Lua 解释器不在
$PATH里（常见于 GUI 启动 Atom），cmd要写绝对路径，例如cmd: "/usr/local/bin/lua"
GUI 启动 Atom 时 PATH 经常失效
终端里能跑 lua -v，但在桌面图标启动的 Atom 里按 F9 却报错 Command not found: lua —— 这是 Linux/macOS 上最典型的环境变量丢失问题。
根本原因：GUI 应用不读 shell 配置文件（如 ~/.zshrc），所以 $PATH 里缺 Lua 路径。
临时解法：terminal 中执行 atom . 启动编辑器，它会继承当前 shell 的 $PATH。
长期解法（推荐）：
- macOS：在
~/Library/LaunchAgents/下建env.plist注入 PATH - Linux（Deepin/Ubuntu）：改
/etc/environment或桌面环境的 session startup 脚本 - Windows：确保
lua.exe所在目录已加入系统级PATH，且 Atom 是从“开始菜单”而非桌面快捷方式启动（后者可能绕过 PATH）
运行失败时先看 build 输出面板，不是报错窗口
按 F9 后底部没弹窗？别急着重装插件。打开 Atom 底部的 Build 面板（通常在输出区左上角有标签），那里会显示真实执行命令、返回码和 stderr。
常见线索：
-
spawn lua ENOENT→atom-build.yml里的cmd找不到解释器，检查路径和 $PATH -
attempt to call a nil value (global 'print')→ Lua 版本错（比如用 Lua 5.1 解释器跑 Lua 5.4 代码），或脚本开头有 BOM 字符 - 空白输出但退出码 0 → 脚本本身没
print或io.write，也可能是args写成了["{FILE_ACTIVE}"]但实际需要传参（如["{FILE_ACTIVE}", "arg1"]）
真正容易被忽略的是：Atom 不校验 atom-build.yml 语法。缩进错一位、多一个冒号、变量名拼错，它就静默失效——build 面板里连命令都不显示，只会说 “No build provider found”。
