Great question—this is a common point of confusion when switching from npm to Clojure/Leiningen. Let's break down both parts of your question clearly.

Why Leiningen Uses a Global ~/.m2/repository by Default #

Leiningen inherits this behavior from Maven (the underlying build tool it relies on), and there are practical, ecosystem-aligned reasons for it:

• Disk space efficiency: Java/Clojure dependencies can be large, and many projects share the same versions of core libraries (like Clojure itself). Storing them globally means you only download each version once, avoiding redundant copies across every project.
• Consistency across projects: A global repository ensures all your projects use the exact same copy of a dependency version. This eliminates subtle bugs that can pop up if different projects have slightly different (or corrupted) local copies of the same library.
• Alignment with the JVM ecosystem: Most JVM-based tools (Maven, Gradle, etc.) use ~/.m2 as the standard local repository. This consistency makes it easier to work across different JVM projects without reconfiguring dependency storage every time.

Can Leiningen Download Dependencies to a Project-Local Directory? #

Absolutely! You have a couple of straightforward options to set this up:

1. Configure a Local Repository Directly in project.clj #

The simplest method is adding a :local-repo setting to your project's configuration. This tells Leiningen to use a project-specific directory for all dependencies. For example:

(defproject my-clojure-project "0.1.0-SNAPSHOT"
  :dependencies [[org.clojure/clojure "1.11.1"]
                 [ring/ring-core "1.10.0"]]
  :local-repo "lib") ; Dependencies will download to the ./lib folder

After adding this, run lein deps as usual—all dependencies will be stored in the lib directory at your project root. Just remember to add lib/ to your .gitignore (or version control ignore file) to avoid committing large dependency files to your repo.

2. Use the lein-localrepo Plugin #

For more advanced local dependency management (like manually adding custom JARs to your project's repo), you can use the lein-localrepo plugin. First, add it to your project's plugins in project.clj:

(defproject my-clojure-project "0.1.0-SNAPSHOT"
  :dependencies [[org.clojure/clojure "1.11.1"]]
  :plugins [[lein-localrepo "0.5.4"]])

You can then use commands like lein localrepo install to add JARs to your project's local repo, or configure the plugin to use a specific directory by default.

内容的提问来源于stack exchange，提问作者Deepak Tatyaji Ahire