ASDF无法正确加载Common Lisp文件，函数未定义求助

我之前用ASDF管理Common Lisp项目时也碰到过一模一样的情况——编译加载都显示成功，但就是有函数找不到，得手动编译单个文件才行。结合经验来看，大概率是这几个地方出了问题，你可以逐一排查：

1. 组件顺序或依赖没理清楚 #

ASDF是严格按照你在系统定义里components列表的顺序来编译加载文件的。如果文件A里调用了文件B的函数，但你把A放在B前面，编译A的时候B的函数还没被定义，虽然Lisp的动态特性可能让编译不报错，但加载后调用就会提示函数未定义。

解决办法：

• 调整components里的文件顺序，把被依赖的文件放在前面；
• 用:depends-on明确每个文件的依赖关系，让ASDF自动处理顺序，比如：

(defsystem "xxx-xxxx"
  :version "0.1"
  :components ((:file "utils")  ; 工具类被其他文件依赖，先编译
               (:file "core" :depends-on ("utils"))  ; core依赖utils
               (:file "api" :depends-on ("core"))))   ; api依赖core

2. 系统定义漏加了文件 #

说不定你有几个.lisp文件没加到系统的components里，ASDF根本没编译它们，自然这些文件里的函数就不存在。

解决办法：

• 核对项目里的所有Lisp文件，确保都在components中列出；
• 如果文件放在子目录，可以用:module批量包含，比如：

(defsystem "xxx-xxxx"
  :version "0.1"
  :components ((:module "src"
                :components ((:file "utils")
                             (:file "core")
                             (:file "services")))))

3. 旧编译缓存搞鬼 #

ASDF会缓存编译后的文件，有时候旧的缓存没被更新，导致新修改的代码没被加载。尤其是你之前手动编译过单个文件，ASDF可能优先用旧缓存。

解决办法：

• 先清理系统缓存：(asdf:clear-system "xxx-xxxx")
• 然后强制重新编译所有文件：(asdf:compile-system "xxx-xxxx" :force t)
• 最后重新加载：(asdf:load-system "xxx-xxxx")

4. 包导出/引用有问题 #

就算文件被编译加载了，如果函数所在的包没导出，或者调用的地方没正确引用这个包，也会提示函数未定义（除非你用完整的包前缀调用）。

解决办法：

• 在函数所在文件的包定义里，用:export导出需要的函数：

(defpackage #:xxx-xxxx.utils
  (:use #:cl)
  (:export #:calculate-score))  ; 导出calculate-score函数

• 在需要调用的文件里，要么用:use导入整个包，要么用:import-from导入特定函数，比如：

(defpackage #:xxx-xxxx.core
  (:use #:cl #:xxx-xxxx.utils)  ; 直接导入utils包的所有导出函数
  ; 或者用(:import-from #:xxx-xxxx.utils #:calculate-score)只导入特定函数
  )

5. 条件编译导致函数没被编译 #

如果你的代码里用了#+/#-这类条件编译宏，比如#+sbcl (defun sbcl-specific-func () ...)，而你当前用的不是SBCL，这个函数就不会被编译定义。

解决办法：检查代码里的条件编译表达式，确保目标函数在当前Lisp实现/环境下会被编译，或者调整编译选项。

先从调整系统依赖顺序和清理缓存开始排查，这两个是最常见的原因，大概率能解决你的问题。

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