惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

The Cloudflare Blog
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
人人都是产品经理
人人都是产品经理
C
Check Point Blog
有赞技术团队
有赞技术团队
H
Help Net Security
V
Vulnerabilities – Threatpost
N
News | PayPal Newsroom
Hacker News - Newest:
Hacker News - Newest: "LLM"
L
LINUX DO - 最新话题
Apple Machine Learning Research
Apple Machine Learning Research
博客园 - 【当耐特】
爱范儿
爱范儿
I
InfoQ
V
Visual Studio Blog
O
OpenAI News
Google DeepMind News
Google DeepMind News
S
Security Affairs
T
Troy Hunt's Blog
P
Palo Alto Networks Blog
Spread Privacy
Spread Privacy
Engineering at Meta
Engineering at Meta
雷峰网
雷峰网
N
Netflix TechBlog - Medium
Latest news
Latest news
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Webroot Blog
Webroot Blog
S
Schneier on Security
MongoDB | Blog
MongoDB | Blog
T
Tor Project blog
V2EX - 技术
V2EX - 技术
Security Latest
Security Latest
Cloudbric
Cloudbric
The GitHub Blog
The GitHub Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
B
Blog RSS Feed
C
CERT Recently Published Vulnerability Notes
T
The Exploit Database - CXSecurity.com
P
Privacy International News Feed
S
Securelist
C
Cisco Blogs
博客园_首页
TaoSecurity Blog
TaoSecurity Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Security Archives - TechRepublic
Security Archives - TechRepublic
P
Proofpoint News Feed
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
T
Threat Research - Cisco Blogs
阮一峰的网络日志
阮一峰的网络日志
S
Secure Thoughts

博客园 - 我才是银古

第16章:常见问题、排错与最佳实践 第15章:扩展生态、MCAD 与外部集成 第12章:实战案例:机械结构与 3D 打印零件 第14章:构建、测试、调试与贡献流程 第13章:OpenSCAD 源码架构与核心执行流程 第11章:预览、渲染、网格精度与性能优化 第09章:列表推导、递归与算法建模 第08章:参数化零件库与复用设计 第10章:导入导出、命令行与自动化 第06章:CSG 布尔建模方法 第07章:二维图形、拉伸、旋转与投影 第05章:基础几何、坐标系与变换 第04章:参数、变量、函数、模块与作用域 OpenSCAD 教程目录 第03章:OpenSCAD 语言基础 第02章:安装、环境配置与开发工作流 第01章:OpenSCAD 项目全景与学习路线 第02章:源码获取、编译与开发环境配置 第01章:OCCT项目全景与学习路线 第18章:二次开发实战与综合案例 第17章:与 Qt VTK Python pythonOCC 生态集成 第18章:综合实战案例 第17章:数据交换与协同 第15章:插件与自定义工作台开发 第14章:Python脚本宏与自动化 第13章:FEM仿真分析 第12章:CAM数控加工 第11章:SurfaceMesh与逆向工程 第10章:Draft二维绘图与BIM建筑 第09章:工程图TechDraw 第07章:参数化表达式与Spreadsheet 第08章:装配设计Assembly 第06章:Part工作台与几何内核 第05章:PartDesign实体特征建模 第04章:草图Sketcher约束建模 第02章:安装版本与工作环境配置 第03章:界面工作台与基础操作 第01章:项目全景与学习路线 第十二章:插件开发、研究功能与最佳实践 第十章:定时任务与自动化(Cron) 第七章:技能、记忆与自学习闭环 第八章:MCP 集成与上下文文件 第六章:工具系统与终端后端 第五章:模型供应商与配置体系 Hermes Agent 教程目录 第十一章:语音、视觉、浏览器与子代理协作 第四章:CLI/TUI 与会话管理 第十二章:学习路线、实战方案与最佳实践 第十一章:源码结构、开发调试与插件开发 第十章:自动化、远程访问、日志与排障 第九章:Control UI、节点、Canvas 与语音能力 第七章:工具、技能、插件与能力扩展 第八章:安全模型、访问控制与沙箱实践 第六章:Agent 工作区、会话与多智能体路由 第五章:多通道消息接入与聊天平台配置 第四章:配置体系、模型接入与认证管理 第三章:Gateway 架构、协议与运行机制 第二章:安装、环境准备与快速上手 第一章:OpenClaw 项目概览与核心定位 oh-my-openagent 教程目录 09-命令模型回退与配置参考 10-实战案例最佳实践与故障排除 05-工作模式-Ultrawork-Prometheus-Atlas 08-Hooks与MCP系统 06-Category与Skill系统 07-核心工具链 04-智能体全景详解 03-安装与环境配置 02-整体架构与多模型编排机制 01-项目简介与核心理念 01-项目概览与学习路线 02-安装部署与工具适配 03-Skill机制与using-superpowers 05-TDD系统化调试与完成前验证 04-需求澄清方案设计与计划编写 07-并行智能体子智能体与Git-Worktree 第六章:代码审查、反馈处理与分支收尾 08-中国特色Skills与本土团队落地 09-MCP构建工作流执行与自定义Skill 第23章:FreeCAD-Python-API Clipper2 C# 源码解读教程 第19章:PolyTree 多边形树结构 第20章:实际应用与最佳实践 第18章:Minkowski 和与差 第17章:RectClip 矩形裁剪优化 第16章:ClipperOffset 偏移类详解 第15章:填充规则详解 第14章:布尔运算执行流程 第13章:ClipperD 浮点裁剪类 第11章:OutRec 与 OutPt 输出结构 第9章:Active 活动边结构 第10章:Vertex 顶点与 LocalMinima 局部极小值 第12章:Clipper64 裁剪类详解 第7章:高精度运算与128位整数 第8章:ClipperBase 基类详解 第5章:枚举类型与常量定义 第6章:InternalClipper 内部工具类 第2章:核心数据结构 - Point64、PointD 第3章:路径与多边形表示 - Path64、PathD、Paths64、PathsD 第4章:矩形边界 - Rect64、RectD
第16章:源码架构与二次开发
我才是银古 · 2026-05-05 · via 博客园 - 我才是银古

第16章:源码架构与二次开发

1. 官方源码结构

FreeCAD 官方仓库的 src 目录体现了核心架构:

  • src/Base:基础类型、异常、工具、数学、参数等。
  • src/App:文档、对象、属性、表达式、事务、重计算等应用核心。
  • src/Gui:主窗口、命令、视图、选择、任务面板、Qt 集成等。
  • src/Mod:工作台模块,例如 Part、PartDesign、Sketcher、TechDraw、Draft、BIM、CAM、Fem、Mesh、Surface 等。
  • src/Main:程序入口。
  • src/3rdPartysrc/Ext:第三方或扩展支持。

这种结构体现 App/Gui 分离:无界面模式也能进行文档和几何处理;GUI 只是其中一层。

2. App 层

App 层是 FreeCAD 的数据模型核心。重要概念包括:

  • Document:文档容器。
  • DocumentObject:文档对象基类。
  • Property:属性系统。
  • Expression:表达式引擎。
  • Transaction:撤销/重做。
  • Recompute:依赖重计算。

理解 App 层有助于开发参数化对象和稳定脚本。对象应通过属性保存状态,而不是只在内存变量中保存。

3. Gui 层

Gui 层负责用户交互:

  • 命令注册与执行。
  • 工具栏和菜单。
  • 3D 视图和 Coin3D 场景。
  • 选择系统。
  • 任务面板。
  • ViewProvider。

开发 GUI 时要考虑无界面环境。核心算法应能在 App 层运行,GUI 只负责输入和展示。

4. Mod 模块

src/Mod 下每个工作台通常有 App、Gui、资源、测试和初始化文件。官方仓库中可见模块包括 Assembly、BIM、CAM、Draft、Fem、Import、Material、Measure、Mesh、OpenSCAD、Part、PartDesign、Sketcher、Spreadsheet、Surface、TechDraw 等。

这说明 FreeCAD 的功能不是一个巨大单体,而是一组围绕共同文档模型协作的模块。

5. C++ 与 Python 的关系

FreeCAD 既使用 C++ 又深度集成 Python:

  • C++ 提供性能、核心对象、几何和 GUI 基础。
  • Python 提供快速扩展、脚本和大量工作台逻辑。
  • SWIG、PyCXX、PySide、Pivy 等技术连接 C++、Python、Qt 和 Coin3D。

开发者应根据需求选择层级:

  • 自动化和业务工具:优先 Python。
  • 性能敏感几何算法:考虑 C++。
  • 自定义 GUI:Python + PySide 通常足够。
  • 核心架构修改:需要 C++ 和完整构建测试。

6. 构建系统

顶层 CMake 配置读取 version.json,设置项目版本,并检测依赖。它包含编译器检查、构建选项初始化、模块依赖检查、LibPack、Doxygen、fmt、yaml-cpp、Python、OpenCASCADE、Qt、Coin3D、Pivy、Boost 等。

开发者应理解:

  • 构建失败常由依赖版本不匹配引起。
  • GUI 构建比无界面构建依赖更多。
  • FEM、BIM、VR 等功能可能启用额外依赖。
  • 开发测试需要 ENABLE_DEVELOPER_TESTS

7. 贡献流程

官方 CONTRIBUTING.md 描述 FreeCAD Contribution Process。核心精神包括:

  • 使用 GitHub Issue 和 Pull Request。
  • PR 应解决一个明确问题。
  • 尽量避免不必要依赖。
  • 每个提交应能编译。
  • 不应破坏 Python API,若不可避免需清楚说明。
  • 贡献必须满足许可证和版权要求。

即使只是插件开发,也应遵循类似原则:小步修改、清晰说明、可测试、尊重兼容性。

8. 阅读源码路线

推荐路线:

  1. 从 README 和 Developers Handbook 理解整体。
  2. 阅读 src/Mod/SketcherPartDesignTechDraw 的目录结构。
  3. 查看某个简单 Python 工作台的 InitGui.py
  4. 阅读 App 层 DocumentObject 和 Property 概念。
  5. 跟踪一个命令从 GUI 到对象创建的调用链。
  6. 用调试构建验证理解。

不要一开始试图读完整仓库。选择一个命令或对象作为切入点更有效。

9. 二次开发边界

修改 FreeCAD 核心源码成本高,需要跨平台构建和社区评审。很多需求可以通过插件完成。判断原则:

  • 只服务本团队业务:插件。
  • 可由 Python API 实现:插件或宏。
  • 需要高性能或核心功能:C++ 模块。
  • 影响大量用户和 API:提交上游 PR 前先讨论。