sbt为何无法识别publishLocal发布的本地构件？

以下是针对你遇到问题的具体排查和解决步骤：

• 强制重新发布库构件
  有时候sbt publishLocal会复用之前的编译缓存，导致新代码没被打包进去。在库项目中执行：

  sbt clean publishLocal
  

  执行后检查~/.ivy2/local/[你的库组织ID]/[库名称]/[版本号]/jars/下的jar包，用jar tf [jar文件名]查看内部类文件，确认新增方法对应的class已包含其中。

• 彻底清理依赖项目的缓存
  仅删除target目录不够，还需要清理依赖管理工具的缓存：

  • 若用Coursier：删除~/.cache/coursier/v1中对应库的缓存条目
  • 若用Ivy：删除~/.ivy2/cache下对应库的缓存目录
    之后在依赖项目中执行：

  sbt clean update compile
  

• 检查版本号类型
  如果你用的是非快照版本号（如1.0.0），sbt和Coursier会默认缓存该版本，不会主动拉取本地更新的构件。解决方法：

  • 改用快照版本号（如1.0.0-SNAPSHOT），快照版本会自动检查本地最新发布的构件
  • 若必须用非快照版本，手动删除本地缓存中对应版本的所有文件后再执行sbt update

• 确认多模块项目的发布完整性
  如果你的库是多模块sbt项目，确保在根目录执行发布命令，覆盖所有子模块：

  sbt "+publishLocal"
  

  （+表示针对所有配置的Scala版本发布）

• 清理IDE缓存（若使用IDE开发）
  如果你在IDE（如IntelliJ IDEA）中编译项目，IDE可能缓存了旧的依赖文件：

  • 执行IDE的「Invalidate Caches / Restart」操作
  • 重新导入sbt项目，确保IDE读取最新的本地依赖

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