ForgeCAD 是一款「代码优先」的开源参数化 CAD 工具：一个普通的.forge.js文件就是活的 3D 模型。本文带你走通 ForgeCAD 全格式导出工作流——3 分钟掌握如何导出 STL、3MF 和 STEP，涵盖 3D 打印、机械制图与 CAD 数据交换三大场景，附常见导出问题排查清单。

🎯 先选对格式：STL、3MF、STEP 各管什么

选对格式，导出工作流成功了一半：

一句话原则：要打印选 STL 或 3MF，要机加工或交付给其他 CAD 软件选 STEP（详见 skills/forgecad-build-model/SKILL.md 中的出货规范：打印件走export stl/export 3mf，机加件走export step）。

🚀 一键安装：3 步跑通环境

在终端依次执行：

npm install -g forgecad # 1. 安装 CLI forgecad login # 2. 登录（本地导出其实可跳过） forgecad studio . # 3. 打开本地编辑器

本地建模、run、导出 STL/3MF 都不需要账号；只有同步云项目或激活许可证才需要登录。装好后可用forgecad doctor检查渲染与精确导出的系统依赖是否齐全。

🖨️ 场景一：导出 STL / 3MF（3D 打印）

先验证，再导出。打印前的标准动作是两条命令：

forgecad run examples/products/cup.forge.js # 快速验证模型能否构建 forgecad check print examples/products/cup.forge.js # 打印就绪检查：壁厚、悬垂、床接触面 forgecad export stl examples/products/cup.forge.js # 导出 STL

• check print会模拟切片器视角，报出具体风险（碰撞、薄壁、过悬等），默认按 0.4mm 喷嘴的 FDM/PLA 保守档评估；
• 想导出彩色或多零件文件？换成 3MF 并拉满网格质量：

forgecad export 3mf cup.forge.js --quality high

--quality有三档：live（最快，适合大模型）、default、high（打印成品推荐）。

⚙️ 场景二：导出 STEP（精确 CAD 交换）

STEP 保留的是精确边界几何（BREP），不是三角网格，适合机加工图档和跨软件协作：

forgecad export step bracket.forge.js forgecad export step bracket.forge.js --backend occt # 可选 OCCT 或原生 truck 内核

需要提醒：export step属于 Production 档——个人非商用可免费运行，商业化出图需 Pro 授权。可用forgecad license查看当前本地授权状态。

🔧 工作流加速技巧：参数覆盖 + 质量控制

导出命令支持在建模前先覆盖参数，不用改代码就能出不同规格：

forgecad export stl bracket.forge.js --param Width=42 forgecad export step bracket.forge.js -p Width=42 -p Height=15 -o out/bracket.step

完整参数表见 skills/forgecad/docs/CLI.md。

📦 不止三种：ForgeCAD 全格式导出速查

相关能力文档在 skills/forgecad/docs/generated/output.md。

🐛 导出失败？3 个高频原因

1. 导出失败不是导出器的问题，而是模型 Bug。非流形体、开放外壳、本应一个零件却熔成一坨——这类问题要在.forge.js里修，官方技能文档原话如此（见 skills/forgecad-build-model/SKILL.md）；
2. 依赖缺失：跑forgecad doctor检查系统依赖；
3. 授权门槛：STEP 等 Production 命令在商用场景需要 Pro，个人非商用直接跑即可。

📂 延伸阅读

• CLI 全量参考：skills/forgecad/docs/CLI.md
• 可运行示例：examples/products/、examples/mechanical/
• 从现有 STL/STEP 反向重建参数化模型：skills/forgecad-reconstruct-cad-file/SKILL.md
• 仓库总览与快速开始：README.md

掌握「run验证 →check print体检 →export出货 →--param变体」这套循环，你的 ForgeCAD 模型就能稳定地从屏幕走向打印床和车间。