OCaml Dune项目自定义模块函数Unbound value错误的原因与解决

错误原因 #

你的代码存在模块嵌套导致的路径引用错误：

• 在lib/markdown.ml中，你在文件名对应的顶层Markdown模块内部，又定义了一个同名的Markdown子模块，convert_markdown_to_html函数实际位于这个子模块中。
• 因此函数的完整引用路径应为Markdown.Markdown.convert_markdown_to_html，而你在generator.ml中使用的Markdown.convert_markdown_to_html无法匹配到正确的函数。

解决方法 #

两种可行修正方案，任选其一即可：

方案1：移除嵌套模块（推荐） #

修改lib/markdown.ml，去掉内部的Markdown子模块，直接在顶层定义函数：

open Omd

let convert_markdown_to_html content =
  content |> Omd.of_string |> Omd.to_html

修改后函数路径变为Markdown.convert_markdown_to_html，与generator.ml中的引用完全匹配，无需改动其他文件。

方案2：修正引用路径 #

若需保留嵌套模块结构，修改lib/generator.ml中的函数引用路径：

let html_content = Markdown.Markdown.convert_markdown_to_html content in

也可在generator.ml开头添加open Markdown，之后直接使用Markdown.convert_markdown_to_html，但前者路径更清晰。

验证 #

修改完成后，执行以下命令重新构建项目：

dune clean && dune build

错误将被消除。

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