修改版LDoc使用dofile调用子文件无法获取主配置全局变量问题
问题原因
该问题是LDoc的沙箱运行机制导致的:
- LDoc加载配置文件时,会将配置代码放在独立的自定义环境表中运行,而非Lua默认的全局
_G环境 - 你直接导入的原生
dofile函数加载子脚本时,默认使用Lua全局环境运行,自然无法访问沙箱内定义的hello变量,子脚本内定义的全局变量也无法写入LDoc的配置沙箱,出现双向变量不通的问题
解决方案
你只需要给LDoc配置沙箱注入自定义封装的dofile函数,让子脚本和主配置共用同一个沙箱环境即可,修改LDoc源码中给沙箱注入API的逻辑,将原生dofile替换为如下实现:
-- 以下代码写在LDoc源码中创建配置沙箱的逻辑处 -- config_env 为LDoc运行config.ld时使用的沙箱环境表 config_env.dofile = function (filename) -- 加载子脚本 local chunk, load_err = loadfile(filename) if not chunk then error(("failed to load %s: %s"):format(filename, load_err)) end -- 兼容不同Lua版本的环境设置 if setfenv then -- Lua 5.1及兼容版本 setfenv(chunk, config_env) else -- Lua 5.2+ 也可在loadfile时直接传入env参数:loadfile(filename, "bt", config_env) debug.setupvalue(chunk, 1, config_env) end -- 运行子脚本,返回值对齐原生dofile return chunk() end
修改完成后,你原有config.ld和auxf.ld的代码无需调整即可正常运行,且子脚本中定义的全局变量也可以被主配置文件正常访问。
临时替代方案
如果你不想修改LDoc源码,且LDoc沙箱已将环境表暴露为配置内的_G变量,也可以直接在config.ld中自行封装带环境的加载函数:
-- config.ld 开头添加自定义加载函数 local function env_dofile(filename) local chunk, err = loadfile(filename) if not chunk then error(err) end setfenv(chunk, _G) return chunk() end hello = "Hello world!" env_dofile("auxf.ld")
内容的提问来源于stack exchange,提问作者AntumDeluge
相关产品推荐
相关产品推荐

