Bazel项目中IntelliJ无法识别MapStruct生成的实现类该如何解决？

核心问题原因 #

Bazel项目的注解处理器输出目录默认不会被IntelliJ自动标记为源代码根目录，不同于Maven/Gradle的自动适配逻辑，需要手动配置让IntelliJ扫描对应生成路径。 #

操作步骤 #

1. 配置Bazel项目视图文件 #

打开你项目根目录的.bazelproject配置文件，在generated_directories字段下添加MapStruct注解处理器的输出路径，格式参考：

generated_directories:
  bazel-bin/<你的模块包路径>/_javac/<对应java_library目标名>/lib<目标名>_annogen

如果不确定具体路径，可以先手动执行一次bazel build <你的mapper所在的目标>，然后在bazel-bin目录下搜索生成的*MapperImpl.java文件，复制对应的上层目录路径即可。

2. 开启IntelliJ注解处理配置 #

依次打开 File > Settings > Build, Execution, Deployment > Compiler > Annotation Processors，选中你的Bazel项目对应模块后做如下配置：

• 勾选 Enable annotation processing
• 「Obtain processors from」选择 Project classpath
• 「Generated sources directory」填写和上一步一致的输出路径即可

3. 同步并重建索引 #

• 执行顶部菜单栏 Bazel > Sync > Sync Project with Build Files 触发项目同步
• 同步完成后执行 File > Invalidate Caches...，选择「Invalidate and Restart」重启IDE
• 重启后等待IntelliJ全量索引跑完，即可正常识别MapStruct生成的实现类

注意事项 #

• 所有路径配置不要写死绝对路径，使用相对路径适配不同开发环境
• 不要手动在项目结构设置里修改源目录标记，Bazel同步时会覆盖手动修改的配置，所有持久化配置必须写在.bazelproject文件中
• 如果同时使用多个注解处理器，把所有生成类的目录都添加到generated_directories列表即可

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