VSCode Metals无法识别Git子模块创建的Scala子项目

1. 确保子模块正常初始化与构建 #

先确认Git子模块代码已完整拉取：

git submodule update --init --recursive

进入子模块目录，手动执行编译验证子模块本身可正常构建：

cd module
sbt compile
cd ..

2. 调整根项目build.sbt配置 #

使用ProjectRef时Metals可能无法自动识别子模块，建议改为直接定义子模块：

lazy val myModule = project.in(file("module"))

lazy val root = project.in(file("."))
  .dependsOn(myModule)

若必须保留ProjectRef，需在根项目中显式触发子模块的Bloop配置生成：

import bloop.integrations.sbt.BloopDefaults

lazy val myModule = ProjectRef(file("module"), "module")

lazy val root = project.in(file("."))
  .dependsOn(myModule)
  .settings(
    BloopDefaults.configSettings,
    bloopGenerate := {
      val _ = bloopGenerate.in(myModule).value
      bloopGenerate.value
    }
  )

3. 强制Metals重新导入项目 #

在VSCode中操作：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
• 选择Metals: Import Build
• 等待导入完成后，检查.bloop目录是否生成myModule.json

4. 匹配版本兼容性 #

确保本地sbt版本与Metals 1.35.0兼容（建议sbt 1.5.x及以上），可在project/build.properties中指定：

sbt.version=1.9.6

5. 清理缓存重试 #

若以上步骤无效，清理相关缓存后重新构建：

• 删除根项目下的.metals、.bloop、target目录
• 删除子模块下的target目录
• 执行sbt clean compile，再触发Metals导入构建

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