Lua的require在CMD正常运行，VSCode调试器中却找不到库

核心问题 #

虽然你指定了和CMD一致的lua.exe路径，但VSCode调试会话的环境上下文（尤其是Lua的模块搜索路径）和CMD运行环境不匹配，导致调试器无法定位到LuaXML的C扩展库LuaXML_lib。

具体解决步骤 #

• 同步环境变量

  1. 在正常运行的CMD窗口中执行以下命令，记录输出的路径值：

     echo %LUA_PATH%
     echo %LUA_CPATH%
     

  2. 打开VSCode的launch.json，添加env字段，将上述记录的路径值填入，确保调试环境继承CMD的Lua搜索路径配置：

     {
         "version": "0.2.0",
         "configurations": [
             {
                 "name": "Lua Debug",
                 "type": "lua",
                 "request": "launch",
                 "program": "${file}",
                 "luaexe": "你的lua.exe完整路径",
                 "env": {
                     "LUA_PATH": "CMD中输出的LUA_PATH内容",
                     "LUA_CPATH": "CMD中输出的LUA_CPATH内容"
                 }
             }
         ]
     }
     

• 手动添加模块搜索路径
  如果不想依赖环境变量，可以在测试代码开头直接指定LuaXML库的位置，覆盖默认搜索路径：

  -- 替换为LuaXML库所在的实际目录
  local luaxml_dir = "C:/your/luaxml/directory/"
  package.path = package.path .. ";" .. luaxml_dir .. "?.lua"
  package.cpath = package.cpath .. ";" .. luaxml_dir .. "?.dll"
  -- 针对不同Lua版本的库文件名（如lua54_LuaXML_lib.dll），可调整通配符：
  -- package.cpath = package.cpath .. ";" .. luaxml_dir .. "lua54_?.dll"
  
  require 'luaxml'
  print('Hello')
  

• 确认工作目录一致性
  调试时的工作目录可能和CMD运行时不同，在launch.json中添加cwd字段，指定为CMD运行时的工作目录：

  "cwd": "${workspaceFolder}"
  

• 检查库文件匹配性
  确保LuaXML_lib的库文件名和Lua版本、架构匹配（比如32位/64位），且文件存在于package.cpath包含的路径下。部分Lua库的C扩展会带有版本前缀（如lua53_LuaXML_lib.dll），此时需要调整require的名称或package.cpath的通配符。

内容的提问来源于stack exchange，提问作者Arthur Attout