vscode本身不执行lua，仅调用本地lua.exe或luajit；所有运行失败、命令未找到、脚本闪退等问题，根源在于解释器未正确安装或path未配置，而非插件缺失。
VSCode 本身不执行 Lua，它只调用你本地装的 lua.exe 或 luajit。所有“点运行没反应”“报 command not found”“脚本秒退”“中文路径失败”，根源都在解释器没配对、没到位——不是插件装得少，是底层可执行文件根本没被系统和 VSCode 正确识别。
为什么 Ctrl+Alt+N 报 command 'lua' not found
Code Runner 默认走终端命令 lua ${file}，但它不关心你 PATH 里有没有 lua，只管照写。终端认不出 lua，就直接崩。
- 先在 VSCode 内置终端（
Ctrl+`）输lua -v；如果报“不是内部或外部命令”，说明 PATH 没生效，得去系统环境变量里把 Lua 安装目录（如C:Lua54）加进去 - 别用
LuaJIT配 Code Runner：它常被识别为luajit，但 Code Runner 的默认 executorMap 里写的是lua，不改配置就必然失败 - Windows 下路径含空格（比如
C:Program FilesLualua54.exe）必须加引号；检查settings.json里的code-runner.executorMap，确保 lua 条目是"lua": ""C:\Program Files\Lua\lua54.exe" "${file}"" - 脚本末尾不加
io.read()，控制台会闪退——这不是错误，只是进程结束太快，你看不到输出
launch.json 断点不生效的常见硬伤
调试失败极少因为插件没装，绝大多数是 launch.json 里几个字段写错，导致调试器连解释器都没启动。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
-
"type": "lua"必须全小写，写成"Type"或"Lua"都静默忽略 -
"request": "launch"是自己起新进程，适合纯脚本；但如果你调试 LOVE2D、NodeMCU 或嵌入式模块，它们不提供标准入口，必须用"request": "attach"，并让宿主程序主动监听（比如love.run()前加require("lldebugger").start()） -
"program": "${file}"看似简单，但若脚本依赖相对路径加载其他模块（require "utils"），就得额外设"cwd": "${fileDirname}"，否则package.path找不到文件 - Windows 用户注意：
"host": "127.0.0.1"和"port": 8888别写反；写成"port": "127.0.0.1"这种类型错位，调试器连 socket 都建不起来
中文路径报 No such file or directory 怎么办
这不是 Lua 解释器的问题，是 Code Runner 在 Windows CMD 下拼接路径时，把 UTF-8 编码的中文当成了乱码字节流传给 ANSI 终端，结果路径彻底损坏。
- 最稳方案：把项目挪到纯英文路径下，比如
D:lua-proj；VSCode 和 Lua 生态对中文路径的支持仍不稳定 - 临时绕过：用 PowerShell 替代 CMD；在 VSCode 设置里搜
terminal.integrated.defaultProfile.windows，设为"PowerShell"，再重启终端（PowerShell 原生支持 UTF-8） - 别信“改系统区域设置为 UTF-8”——Windows 10/11 的 Beta UTF-8 模式会影响大量旧程序，风险远大于收益
- 如果必须用中文路径，且用的是 Lua 5.4+，可在脚本开头手动修正：
arg[0] = arg[0]:gsub("\", "/"):gsub(" ", "%%20")，但这只是补丁，不是根治
sumneko.lua 状态栏不显示 Lua (running)
语言服务器没起来，补全、跳转、诊断全失效。它不依赖调试插件，只认两件事：解释器存在，且路径配置正确。
- 检查
settings.json里是否有"lua.runtime.path"；值必须是可执行文件的**完整路径**，比如"C:/Lua54/lua.exe"（正斜杠或双反斜杠，单反斜杠会解析失败） - 删掉冲突插件：EmmyLua、Lua Dev Tools 等会抢占
.lua文件类型，导致 sumneko 启动被禁；右下角状态栏点 Lua 图标，如果弹出多个选项，说明已冲突 - 全局变量标红（比如
love、node）不是语法错，是没声明；在项目根目录建.luarc.json，写入：{"runtime.version":"Lua 5.4","diagnostics.globals":["love","print"]}；别往settings.json里塞lua.diagnostics.globals，那是全局污染 - 重启语言服务器：按
Ctrl+Shift+P→ 输入Restart TS Server（误触）→ 实际该输Restart Lua Server，或者直接关 VSCode 再开
真正卡住人的从来不是“怎么配”，而是“哪一步漏了”。比如 lua -v 能跑通，不代表 launch.json 里的 program 路径就一定对；比如中文路径在 CMD 里失败，不代表换到 PowerShell 就万事大吉——PowerShell 的 profile 可能加载了破坏编码的模块。越轻量的工具链，越依赖每个环节的严丝合缝。
