Delphi无法编译自定义包中的引用单元问题求助

• 检查单元名称大小写匹配：Delphi 11默认启用Strict Unit Name（项目选项→Delphi Compiler→Compiling），旧版本Delphi对大小写不敏感。确认应用中引用的单元名和包中实际单元文件名完全一致（包括大小写），比如包中是MyCustomUnit.pas，代码里不能写成mycustomunit。

• 验证包的编译输出路径与IDE配置同步

  • 确认自定义包的Output directory和Unit output directory设置为/Dcu/（包选项→Building），且该路径已添加到IDE的Library Path（Tools→Options→Language→Delphi→Library→Library Path），注意区分32位/64位平台的路径配置。
  • 检查包编译生成的.dcp文件是否存在于/Dcu/目录，IDE必须能找到.dcp才能解析包中的单元引用。

• 确认应用项目的包依赖设置

  • 打开应用项目的Project→Options→Packages，确保自定义包已添加到Runtime packages列表（运行时包）或Design packages（设计时包），且勾选Link with runtime packages（若使用运行时包模式）。
  • 若应用是静态编译（不使用运行时包），需将自定义包的.pas单元直接添加到应用项目中，或把包的源文件路径加入应用的Search Path。

• 清理编译缓存

  • 删除应用项目和自定义包的.dcu、.dcp、.bpl文件，手动清空/Dcu/目录，然后重新编译自定义包，再编译应用项目。
  • 关闭IDE后，删除Documents\Embarcadero\Studio\22.0\Cache目录下的所有文件，重启IDE后重新导入包。

• 检查单元的uses子句与包的导出设置

  • 打开自定义包的.dpk文件，确认目标单元已添加到包的contains列表中，且没有被错误标记为hidden（默认不标记）。
  • 若单元中有Register过程（用于组件注册），确认该过程已正确实现，且包的{$R *.res}和{$R *.dfm}（如果有）编译正常。

• 排查平台/架构差异

  • 确认自定义包和应用项目的编译平台一致（比如都是Win32或Win64），Delphi 11的跨平台配置容易出现路径不匹配问题，需分别检查对应平台的Library Path。

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