Formily 源码深度参考手册 ​

本文档基于 alibaba/formily 仓库（本地版本 @formily/core 2.3.7）整理，目标是面向有经验前端工程师的深度技术参考资料：不仅讲“是什么”，更强调“为什么这么设计”以及“代码和演进依据”。

目录 ​

1. 仓库与整体架构总览
2. @formily/reactive 响应式内核
3. @formily/core 表单领域模型
4. Path 系统与 Query 机制
5. 联动系统：Effects / Reactions / x-reactions
6. JSON Schema 编译与协议扩展
7. React 绑定层与渲染策略
8. 性能设计与工程化权衡
9. 关键设计决策与 Issue/PR 依据
10. 高频思考题（含参考回答）
11. 源码证据摘录与解读

源码版本 ​

• Formily Monorepo: alibaba/formily
• 核心包版本: 2.3.7
• 分析时间: 2026年3月

阅读方法（建议） ​

• 先读 01 + 03：建立统一领域模型认知（Form / Field / Graph / Heart）。
• 再读 02 + 04 + 05：掌握“性能 + 联动”核心机制。
• 继续 06 + 07：掌握 Schema 动态化与 React 渲染桥接。
• 最后 08 + 09 + 10：形成技术表达与架构权衡能力。

证据来源说明 ​

本文档的结论来自三类证据：

1. 源码证据：packages/core、packages/reactive、packages/json-schema、packages/react、packages/reactive-react、packages/path。
2. 官方文档/指南：仓库内 docs/guide 与各包 docs/guide。
3. 社区演进证据：GitHub Issue/PR（用于说明设计边界与演进方向）。

参考资料 ​

• 仓库主页: https://github.com/alibaba/formily
• 官方文档: https://formilyjs.org
• Issues: https://github.com/alibaba/formily/issues
• Discussions: https://github.com/alibaba/formily/discussions