I'm trying to include a third-party library in my Java project within IntelliJ IDEA, but I keep getting "Class not found" errors at runtime. What is the official, correct way to add these .jar files to the project structure so they are recognized by the compiler and included in the artifact build? Should I be adding them as global libraries, or is it better to attach them directly to specific modules through the dependencies tab?
3 answers
The most reliable way to add a JAR is through the "Project Structure" menu. Go to File > Project Structure (or press Ctrl+Alt+Shift+S). Under Project Settings, select Modules, then navigate to the Dependencies tab. Click the green "+" icon on the right, select "JARs or Directories...", and browse to your downloaded file. For better organization, I highly recommend creating a lib folder in your project root and moving your JARs there before adding them. This ensures the paths are relative to your project, making it easier to share the code with other developers. After adding, ensure the scope is set to "Compile" so it’s available during both development and runtime.
If I add a JAR this way, will it automatically be included in my final executable JAR when I build the artifact, or do I need to manually configure the artifact layout as well?
For any modern project, you really should use Maven or Gradle. You just add a line to your pom.xml or build.gradle, and IntelliJ handles the download and classpath setup automatically.
I agree with David. While manual addition works for small learning projects, using a build tool is the industry standard. It avoids the "works on my machine" syndrome and manages transitive dependencies which can be a nightmare to track manually.
Brian, simply adding it as a dependency isn't enough for the final export. You must also go to Project Structure > Artifacts and ensure the library is added to the "Output Layout." If you see the library under "Available Elements" on the right, you need to right-click it and select "Extract into Output Root" or "Put into Output Root." Without this step, your code will compile fine in the IDE but will throw a NoClassDefFoundError the moment you try to run the standalone JAR file on another machine.