如何使用Verilog mode AUTOINST？模块名与文件名不同的适配方案

DevOps 小满

2026-5-19

解决Verilog Mode AUTOINST模块与文件名/路径不匹配的问题

遇到模块名和子目录里的文件名不一致导致AUTOINST失效的情况，你可以试试这几个实用的方法：

1. 配置`verilog-auto-inst-path`指定搜索路径

首先确保Emacs知道要去哪些子目录找文件。你可以在.emacs或者项目的.dir-locals.el里添加路径配置：

(setq verilog-auto-inst-path '("./src/submodule_dir" "./src/another_subdir"))

这样Verilog Mode会自动在这些子目录里遍历所有.v文件，哪怕模块名和文件名不一样，只要目标文件里定义了InstModule，就能被识别到。

2. 用`// AUTOINST_PATH`注释手动指定单个模块的路径

如果只是个别模块有这个问题，不想全局修改搜索路径，可以在需要实例化的文件里，在AUTOINST块上方加个注释，直接指定该模块所在的文件路径：

// AUTOINST_PATH: ./src/submodule_dir/non_InstModule.v
// AUTOINST
//      InstModule inst_u (
//          .clk(clk),
//          .rst(rst)
//      );
// END_AUTOINST

这个方法更精准，只针对当前要实例化的InstModule生效。

3. 用`verilog-module-name-map`建立模块与文件的映射

如果模块和文件名的对应关系比较固定，还可以在配置里直接建立映射表，让Verilog Mode明确知道每个模块对应的文件：

(setq verilog-module-name-map
      '(("InstModule" . "./src/submodule_dir/non_InstModule.v")
        ("OtherModule" . "./src/other_dir/other_file.v")))

这样每次遇到InstModule的实例化，就会直接去指定的文件里找模块定义，完全不用依赖文件名匹配。