LDoc 是一个 Lua 文档生成器，旨在与 LuaDoc 兼容，因此遵循各种 Doc 工具设定的格式： --- 摘要以句号结束。 -- 一些描述，可以跨越多行。 -- @param p1 第一个参数 -- @param p2 第二个参数 -- @return 一个字符串值 -- @see second_fun function mod1.first_fun(p1,p2) end 支持如 see 和 usage 等标签，通常可以从代码中推断出函数和模块的名称。 LDoc 旨在提供更好的诊断信息：如果找不到 @see 引用，则会给出引用的行号。LDoc 了解那些未使用 module() 的模块。这一点很重要，因为该函数在 Lua 5.2 中已被弃用。并且你可以通过使用 Markdown 避免在注释中嵌入 HTML。 LDoc 还可以与 Lua C 扩展代码一起使用，并提供一些便捷的快捷方式。