IntelliJ IDEA：更新build.sbt依赖时本地构件从模块丢失问题

安全阿岳

2026-5-29

Hey there, I’ve dealt with this exact frustration using IntelliJ and SBT—having to reattach local JARs every time I tweak the build.sbt is such a time sink! Let me walk you through the permanent fixes I’ve used:

1. Declare Local JARs in build.sbt (The Right Way)

The root problem is that manual UI-based dependencies get overwritten when SBT syncs, because IntelliJ resets module dependencies to match what’s in your build file. So the solution is to define those local JARs directly in build.sbt, so SBT (and IntelliJ’s sync) recognizes them automatically.

You have two solid options here:

Option 1: Reference individual JAR files
Add this line to your build.sbt, swapping in your JAR’s actual path and dummy coordinates (the group/artifact/version can be whatever you want, as long as they’re consistent):
```
libraryDependencies += "com.yourteam" % "custom-local-lib" % "1.0.0" from "file:///absolute/path/to/your.jar"
```
If the JAR lives inside your project (like a lib subfolder), use a relative path for portability:
```
libraryDependencies += "com.yourteam" % "custom-local-lib" % "1.0.0" from "file:lib/your-local.jar"
```
Option 2: Use SBT’s default unmanaged folder
Create a lib directory in your project root, then drop all your local JARs into it. SBT automatically scans this folder for dependencies by default—no extra code needed! IntelliJ will pick these up during syncs without you having to do anything manual.

2. Lock in the Lib Folder in IntelliJ (If Needed)

If you already have a lib folder but IntelliJ still drops the dependencies after sync:

Open File > Project Structure > Modules
Select your module, go to the Dependencies tab
Click the + button, choose JARs or directories
Select your lib folder, and in the popup, pick Jar Directory (not individual JARs)
Check Export if you need these JARs available to dependent modules, then hit OK
Now when you sync SBT, IntelliJ will keep this folder as a persistent dependency source.

3. Stick to SBT Sync Instead of Manual Overrides

Remember: Any dependency you add via IntelliJ’s UI alone will get wiped when you sync SBT, because it’s not part of the build definition. Always prioritize defining dependencies in build.sbt or using the lib folder method—this ensures consistency between SBT and IntelliJ.

Pro tip: After updating build.sbt, use the Refresh all SBT projects button in IntelliJ’s SBT tool window (the little circular arrow) instead of reimporting the entire project. This syncs the build changes without resetting your UI configs unnecessarily.

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