Clojure 命名空间：ns 与 require

Clojure 的命名空间不仅是代码组织的方式，更是构建模块化应用的基石。理解 ns 宏与 require 的配合机制，能够让你清晰无误地管理代码依赖。本指南将直接剖析 ns 的核心用法，通过具体步骤演示如何引用、别名和加载代码。

理解 ns 宏

ns 宏位于 .clj 文件的第一行，它定义了当前文件的上下文环境。所有在该文件中定义的 def、defn 都归属于这个命名空间。

1. 创建一个新的 Clojure 文件，例如 src/my_project/core.clj。
2. 输入以下代码作为文件的第一行：

(ns my-project.core)

这行代码声明了当前命名空间为 my-project.core。在 Java 虚拟机（JVM）底层，这会将对应的文件路径转换为 my_project/core.clj。

使用 :require 引用库

在 ns 宏中，:require 是最常用的指令，用于加载其他命名空间中的代码。它不仅加载代码，还能让你决定如何调用其中的函数。

1. 修改 ns 宏，添加 :require 向量。
2. 输入以下代码引用 Clojure 内置的字符串库：

(ns my-project.core
  (:require [clojure.string]))

此时，若要调用该库中的函数，必须使用全限定名称。

3. 调用 join 函数来测试引用：

(clojure.string/join "-" [1 2 3])
;; 返回结果 "1-2-3"

利用 :as 设置别名

每次都输入全限定名称（如 clojure.string）既繁琐又影响代码可读性。使用 :as 关键字可以为引用的命名空间指定一个简短的别名。

1. 替换之前的 :require 代码，添加 :as 别名：

(ns my-project.core
  (:require [clojure.string :as str]))

2. 更新函数调用代码，使用别名 str 代替原名：

(str/join "-" [1 2 3])
;; 返回结果 "1-2-3"

这样做不仅减少了输入，还明确了函数的来源（即 str 库）。

使用 :refer 引入特定函数

如果你希望直接调用某个函数而无需加命名空间前缀，可以使用 :refer。这类似于 Java 中的 import static。

1. 修改 :require 部分，指定要引入的具体函数列表：

(ns my-project.core
  (:require [clojure.string :as str
                          :refer [join split]]))

2. 直接输入函数名进行调用，省略前缀：

(join "-" [1 2 3])
;; 返回结果 "1-2-3"

3. 慎用 :refer :all。虽然它可以引入命名空间下的所有公有函数，但这极易造成命名冲突，应尽量避免。

解决命名冲突：:rename

当两个不同的命名空间包含同名函数时，使用 :refer 会产生冲突。:rename 允许你引入函数的同时给它起个新名字。

假设我们引用了两个包含 format 函数的库：

1. 编写如下 :require 代码，使用 :rename 映射规则：

(ns my-project.core
  (:require [clojure.string :as str]
            [some.format-lib :as fmt
                             :refer [format]
                             :rename {format fmt-format}]))

在上述代码中，[format fmt-format] 的意思是：将 some.format-lib 中的 format 函数引入，但在当前文件中将其重命名为 fmt-format。

2. 调用重命名后的函数：

(str/format "Hello %s" ["World"])  ; 使用 clojure.string 的 format，带前缀
(fmt-format "Date: %s" ["2023"])    ; 使用 some.format-lib 的 format，重命名后调用

引用 Java 类：:import

Clojure 运行在 JVM 上，经常需要与 Java 类交互。虽然可以使用 import 函数，但在 ns 宏中统一管理是最佳实践。

1. 添加 :import 指令到 ns 宏中。
2. 输入 Java 类的全路径，支持从同一包中导入多个类：

(ns my-project.core
  (:require [clojure.string :as str])
  (:import [java.util Date UUID]
           [java.io File]))

3. 实例化这些 Java 类：

(def current-date (Date.))
(def file (File. "/tmp/log.txt"))

注意调用 Java 构造函数时，需要在类名后加 .。

常用指令对比表

为了快速查阅，下表总结了 ns 宏中引用指令的主要区别与用法。

综合配置示例

将上述知识点组合，一个标准且清晰的 ns 声明通常如下所示：

(ns my-project.web.handler
  "处理 HTTP 请求的核心逻辑"
  (:require [clojure.string :as str]
            [clojure.data.json :as json]
            [my-project.db.core :as db]
            [my-project.utils.misc :refer [log-info]]
            [ring.util.response :as resp
                               :refer [response]])
  (:import [java.util Date]
           [java.sql SQLException]))

1. 复制上述代码模板。
2. 替换 my-project 为你的实际项目名。
3. 根据实际需求，增减 :require 和 :import 中的库。

掌握 ns 与 require 的组合，能够确保你的 Clojure 项目代码结构清晰、依赖关系明确且易于维护。