根本原因是lua解释器启动时lua_path和lua_cpath未包含luarocks安装路径，导致require无法定位模块；需手动配置或改用luarocks自带的lua解释器，并确保vscode调用正确路径及设置绝对路径而非波浪号。
为什么 require 找不到用 luarocks install 装的模块？
根本原因不是 VSCode 本身的问题，而是 Lua 解释器启动时的 LUA_PATH 和 LUA_CPATH 没包含 LuaRocks 的安装路径。VSCode 默认调用系统 lua 命令，它压根不知道你用 luarocks install --local 装到用户目录下的模块在哪。
典型表现：module 'luasocket' not found，但终端里跑 luarocks list 明明显示已安装。
- 检查当前 Lua 解释器路径：在终端运行
which lua，确认是不是你期望的那个（比如/usr/local/bin/lua或~/.luarocks/bin/lua） - 运行
lua -e "print(package.path)"和lua -e "print(package.cpath)"，看输出里有没有类似~/.luarocks/share/lua/5.4/?.lua这样的路径 - 如果没出现，说明 LuaRocks 安装路径没被注入——必须手动补上，或改用 LuaRocks 自带的解释器
VSCode 中正确配置 Lua 解释器路径
别依赖系统默认 lua，直接让 VSCode 启动 LuaRocks 绑定的 Lua 环境。这个环境自带正确的 package.path 和 package.cpath。
- 找到 LuaRocks 的 Lua 可执行文件路径，通常为：
~/.luarocks/bin/lua（Linux/macOS）或%APPDATA%\Local\Programs\LuaRocks\bin\lua.exe（Windows） - 在 VSCode 设置中搜索
lua.runtime.version，设为5.4（或你实际用的版本） - 关键一步：在工作区根目录下创建
.vscode/settings.json，写入：{ "lua.runtime.path": "~/.luarocks/bin/lua" }（注意：VSCode 不支持~展开，务必替换成绝对路径，如/home/you/.luarocks/bin/lua） - 重启 VSCode 或重新加载窗口，再按
F5调试，require就能命中 LuaRocks 安装的模块了
luarocks install 时加不加 --local 影响很大
不加 --local 会把包装进系统级路径（如 /usr/local/share/lua/5.4/），需要 root 权限，且和 VSCode 启动的用户环境常不一致；加了 --local 才会落到用户目录，和 VSCode 的常规运行身份匹配。
- 推荐始终使用：
luarocks install luasocket --local - 装完后检查：
ls ~/.luarocks/lib/luarocks/rocks-5.4/应该有对应 rock 的目录 - 如果误装成全局，又不想 sudo 卸载，可用
luarocks remove luasocket --local先清空本地缓存，再重装 - 注意：某些 rocks（如
lpeg）含 C 模块，--local安装后其.so/.dll文件位置也必须出现在package.cpath中，否则报cannot load module
调试时仍报错？优先检查这三个地方
很多“明明装了却找不到”的问题，其实卡在路径拼接或权限细节上。
- VSCode 终端和调试器用的不是同一个 shell 环境：调试器可能不读取你的
~/.bashrc或~/.zshrc，所以即使你在 shell 里设置了LUA_PATH，VSCode 调试时也不生效 -
package.path中的?是占位符，但路径末尾必须带/?.lua，不能只写~/.luarocks/share/lua/5.4（缺了斜杠和通配） - Windows 用户特别注意：路径分隔符必须是
;（不是:），且反斜杠要双写或用正斜杠，例如：C:/Users/You/.luarocks/share/lua/5.4/?.lua
最稳的做法，永远用 LuaRocks 自带的 lua，而不是系统 lua —— 它的路径初始化逻辑已经由 luarocks 预置好了，少一个出错环节。
