Lua文件大纲为空是因为缺少lua-language-server支持，需安装Sumneko插件、确保服务器二进制在PATH中且路径配置正确、文件语言模式设为Lua，并在项目根目录配置.luarc.json声明runtime.version和globals，同时开启Outline: Enabled与Show All Symbols。
为什么 Lua 文件在 VSCode 大纲里空空如也？
不是你操作错了，而是 VSCode 默认根本不认识 Lua 的函数、变量、表结构——它没语言服务器支持，大纲就只能看到空行或缩进块。你点 Ctrl+Shift+O，结果一片空白，或者只显示几个零星的 local 变量，根本看不到 function 或 return 后面的顶层符号，这说明 Lua 语言服务器（lua-language-server）没跑起来，或者没正确关联到当前文件。
确保 lua-language-server 正在工作且识别当前文件
大纲依赖语言服务器提供的符号信息，不是靠简单语法高亮。必须确认三件事同时成立：
-
Lua插件（sumneko 官方版）已安装并重启过 VSCode -
lua-language-server二进制在系统 PATH 中可用，且 VSCode 设置里Lua: Runtime Path指向了它（比如/usr/local/bin/lua-language-server） - 当前文件右下角语言模式是
Lua（点击那里可手动切换），而不是Plain Text或JavaScript
如果其中任一环断掉，大纲就不会加载符号。常见坑：装了插件但没装服务器；装了服务器但路径填错（比如填成 lua 而不是 lua-language-server）；或者文件后缀是 .luau 或自定义扩展名，没在设置里映射到 lua 语言模式。
项目根目录必须有 .luarc.json 或 .vscode/lua.json
没有配置文件，lua-language-server 就不知道该按 Lua 5.1 还是 5.4 解析，也不知道 love、cc、node 这些全局变量是否合法——它会直接过滤掉所有带这些名字的声明，导致对应函数不进大纲。
在项目根目录建一个 .luarc.json，最简内容如下：
{"runtime.version": "Lua 5.4", "diagnostics.globals": ["print", "table"]}
如果你用 Love2D，就把 love 加进去；用 Cocos Creator，加 cc；否则它们声明的函数全被当“未定义变量”静默忽略，自然不会出现在大纲里。
检查大纲视图本身是否启用 + 显示全部符号
即使语言服务跑起来了，VSCode 默认也可能隐藏局部变量、local function 或模块导出项。你需要手动打开两个开关：
- 确保设置中
Outline: Enabled是开启状态（搜 “outline enabled” 即可） - 把
Outline: Show All Symbols设为true（默认是false），不然只会显示“顶级 public 符号”，而 Lua 里大量逻辑写在local function里，它们就彻底隐身了
另外，别依赖侧边栏图标自动出现——有时它被折叠在“资源管理器”底部。最稳方式是始终用 Ctrl+Shift+O 呼出，再输函数名试试能不能搜到。
真正卡住的地方往往不在 Lua 语法本身，而在语言服务器和 VSCode 之间那层配置胶水：路径对不对、版本声明准不准、全局变量白名单有没有漏——少一个，大纲就少一半内容。
