Delphi 10.4.2中如何构建仅含所用工具函数的单元以减小发布包体积？

Delphi 10.4.2的编译机制 #

Delphi的编译以单元为基础，但**智能链接（Smart Linking）**是控制最终程序体积的核心特性。在Release模式下，智能链接默认开启，它会扫描整个项目代码，自动剔除未被直接或间接引用的函数、类方法等冗余代码——只要这些代码没有被标记为导出（export）、没有触发初始化/终结化逻辑，也不是全局依赖的一部分，都会被从最终可执行文件中移除。

是否需要担忧冗余代码增大体积？ #

常规开发场景下，不用过度担心。因为Release模式的智能链接会自动处理未使用的工具函数。只有当你的工具单元包含大量全局变量、初始化/终结化代码，或者函数被标记为export（用于DLL导出）时，这些未被使用的部分才会被保留下来，这时才需要考虑优化。

如何确保仅包含实际使用的函数？ #

• 确认智能链接开启：在项目选项的Linking面板中，勾选Use smart linking（Release版默认已开启，Debug版通常关闭以方便调试）。
• 拆分细粒度单元：将不同功能域的工具函数拆分到独立单元，比如把字符串处理函数放到StringUtilsEx.pas，日期处理放到DateHelper.pas，文件操作放到FileUtilsEx.pas。这样新项目只需引用用到的单元，从源头减少冗余。
• 清理单元冗余内容：不要在工具单元中添加无关的全局变量、初始化代码，这些内容即使没有函数被调用，也会被编译进最终程序。
• 避免随意使用export：除非需要将函数暴露给DLL调用，否则不要给工具函数加export关键字，带有该标记的函数会被强制保留，不受智能链接影响。

Delphi通用工具库的常规处理方式 #

• 按功能维度拆分单元：这是行业通用做法，每个单元只聚焦一类功能，既方便开发者按需引用，也便于后续维护和扩展。
• 采用静态库包：如果工具函数数量较多，可以将其封装为静态包（Static Packages）。静态包在编译时会被直接链接到主程序中，配合智能链接，只会包含项目实际用到的代码，相比动态包（Dynamic Packages），无需附带额外DLL，也能有效控制体积。
• 拒绝大而全的单一单元：不要把所有工具函数都塞进一个巨型单元，这会增加编译时间，也不利于按需引用，还会提升维护难度。
• 清晰命名单元：采用[功能]UtilsEx或[功能]Helper的命名方式，比如SysUtilsEx.pas（扩展系统工具）、UIHelper.pas（UI辅助工具），让开发者快速识别单元用途，精准引用。

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