XiangShan项目中IntelliJ+Mill+BSP调试断点失效问题求助

针对你在WSL2 Ubuntu 22.04环境下，使用IntelliJ Ultimate 2023.3搭配Mill 0.12.3调试XiangShan项目时遇到的断点灰色、调试器不触发问题，可按以下步骤排查解决：

• 确认BSP连接状态
  打开File > Settings > Build, Execution, Deployment > Build Tools > BSP，检查Mill BSP是否处于Connected状态。若未连接，点击Add BSP Connection，选择XiangShan项目根目录，等待Mill重新生成BSP配置。

• 强制生成调试编译符号
  Mill默认编译可能未包含调试信息，需确保编译时生成完整调试符号：

  • 在Run/Debug Configuration中，为对应Mill任务添加VM参数：-Dmill.scalacOptions=-g:vars
  • 或在项目build.sc的目标模块中显式设置编译选项：

    object xsModule extends ScalaModule {
      override def scalacOptions = super.scalacOptions() ++ Seq("-g:vars")
    }
    

  执行mill clean后重新编译项目，确保class文件包含调试符号。

• 修复WSL2文件系统访问问题
  确保IntelliJ通过WSL远程开发模式打开xs-env下的XiangShan项目，避免直接访问Windows挂载的WSL目录——这种挂载方式可能导致文件权限、符号链接异常，使调试符号无法被IntelliJ识别。切换到WSL远程窗口后重新导入项目。

• 验证断点位置有效性
  确保断点设置在可执行代码行上，避开注释、空行或仅含变量声明的行。针对Chisel逻辑，确认断点所在代码会在仿真流程中被执行（比如仿真入口函数、硬件生成的关键逻辑分支）。

• 同步插件与工具版本

  • 将Mill升级到0.12.x系列最新稳定版，旧版本可能存在BSP协议兼容性问题
  • 在IntelliJ中更新Scala插件和BSP插件到最新版本（通过File > Settings > Plugins操作）

• 使用Mill工具窗口启动调试
  不要直接点击IntelliJ默认的Debug按钮，而是通过右侧边栏的Mill工具窗口找到目标仿真/调试任务，右键选择Debug 'mill <module>.taskName'启动调试会话，确保调试器与Mill编译流程完全绑定。

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