从草图到拉伸只需5步:用 SolidWorks Automation Skill 玩转 Python COM 自动化的实战教程

原创2026-10-13 22:21:011,829 阅读
文章标签:AI 技能MCP 服务工业制造桌面应用3D建模CLIAI 应用

从草图到拉伸只需5步:用 SolidWorks Automation Skill 玩转 Python COM 自动化的实战教程

SolidWorks Automation Skill 是一个基于 Python COM 接口的开源 CAD 自动化工具包,用几行 Python 代码即可驱动 SolidWorks 完成零件建模、装配、出图和 STEP 导出。本文以"50mm 圆柱体"为例,带你走完从草图绘制到拉伸成型再到文件导出的完整 5 步流程,零基础也能快速上手。


认识 SolidWorks Automation Skill:它能帮你做什么

SolidWorks Automation Skill 把 SolidWorks 的 COM 自动化 API 封装成了友好的 Python 函数,覆盖:

  • 🔧 零件建模 — 草图、拉伸、旋转、倒角、圆角、阵列
  • ⚙️ 装配体操作 — 添加组件、配合关系、干涉检查
  • 📐 工程图出图 — 三视图、剖视图、尺寸标注、BOM
  • 💾 文件导出 — STEP、STL、IGES、PDF、DXF 等通用格式
  • 🔌 MCP Server — 接入 Codex / Claude / Cursor 等 AI 工具

核心模块文件一览:

模块路径 功能说明
scripts/sw_connect.py 连接 SolidWorks、文档管理
scripts/sw_part.py 零件建模(草图 + 特征)
scripts/sw_session.py 友好会话 API,一行新建/保存/导出
scripts/sw_export.py 多格式文件导出
scripts/sw_review.py 多视角预览与结果自审查
references/part-modeling.md 零件建模 API 完整参考
references/troubleshooting.md 常见问题排查手册

SolidWorks Automation Skill 的 CAD Studio 桌面工作台界面,展示 Python COM 自动化的图形化管理入口


环境准备:3 步搞定 Python COM 自动化环境

第 1 步:确认系统要求

  • Windows 10 / 11
  • SolidWorks 2024 或 2026(合法安装)
  • Python 3.10+(64 位)

第 2 步:安装 Python 依赖

python -m pip install "pywin32>=305" "comtypes>=1.2.0"

pywin32 提供 win32com.client,是 Python 连接 SolidWorks COM 接口的核心依赖,缺了它脚本无法启动 SolidWorks。

第 3 步:运行环境自检

python scripts/sw_preflight.py

scripts/sw_preflight.py 会自动检测 pywin32 / comtypes 是否就绪、SolidWorks 是否已安装。缺少依赖时会询问是否授权 AI 自动补齐,拒绝则给出手动安装命令。

💡 提示:运行前确保 SolidWorks 已启动,且 Python 位数(64 位)与 SolidWorks 保持一致,否则会报"无效的类字符串"错误。


从草图到拉伸的 5 个核心步骤

以下代码基于 examples/01_basic_part.py,目标是创建一个直径 50mm、高 50mm 的圆柱体。

步骤 1:连接 SolidWorks

from sw_connect import connect_solidworks, mm, new_document

sw, _ = connect_solidworks()

connect_solidworks() 会优先连接已运行的 SolidWorks 实例,找不到时自动启动新实例。mm(50) 将 50mm 转换为 SolidWorks API 内部使用的单位(米),这是最常见的单位陷阱,用辅助函数转换可以避免手动换算出错。

步骤 2:新建零件文档

model = new_document(sw, "part")

步骤 3:在前视基准面绘制圆形草图

from sw_part import start_sketch, sketch_circle, end_sketch

start_sketch(model, "Front Plane")
sketch_circle(model, 0, 0, mm(25))  # 圆心 (0,0),半径 25mm
end_sketch(model)

⚠️ 中英文版本差异:英文版基准面名为 "Front Plane",中文版为 "前视基准面"。start_sketch() 已内置自动兼容逻辑,无需手动切换。

步骤 4:拉伸成实体

from sw_part import extrude_boss

extrude_boss(model, "Sketch1", mm(50))  # 拉伸 50mm

extrude_boss() 内部封装了 FeatureExtrusion3 的全部复杂参数(终止条件、方向、合并策略),自动处理草图选择。完整参数说明见 references/part-modeling.md 的"FeatureExtrusion3 参数详解"章节。

步骤 5:保存零件并导出 STEP

from sw_connect import save_document
from sw_export import export_to_step

save_document(model, r"C:\temp\cylinder.sldprt")
export_to_step(model, r"C:\temp\cylinder.step")

完成后 C:\temp\ 下同时出现 SolidWorks 原生文件(.sldprt)和通用交换格式(.step),可直接用于下游 CAE 或 3D 打印。

SolidWorks Automation Skill 代码驱动生成的复杂测试件模型与工程图,展示 Python COM 自动化的真实建模效果


更简洁的写法:Session API 让代码少一半

SolidWorksSession 把"连接 → 新建 → 建模 → 保存 → 导出"收敛到几行代码,适合日常快速建模。参考 examples/06_friendly_api.py:

from sw_session import SolidWorksSession
from sw_connect import mm
from sw_part import sketch, sketch_circle, extrude_boss

session = SolidWorksSession()
model = session.new_part()

with sketch(model, "Front Plane") as sketch_name:
    sketch_circle(model, 0, 0, mm(25))

extrude_boss(model, sketch_name, mm(50))
session.save(model, r"C:\temp\cylinder.sldprt")
session.export(model, r"C:\temp\cylinder.step")

with sketch(...) 上下文管理器自动处理草图的进入和退出,避免手动调用 start_sketch() / end_sketch() 时遗漏导致的拉伸失败。


常见问题快速排查

现象 原因 解决方法
连接失败,报"无效的类字符串" SolidWorks 未安装或 COM 未注册 确认 SolidWorks 已安装,可指定版本号 Dispatch("SldWorks.Application.32")
拉伸返回 None 草图未闭合或单位错误 检查草图是否闭合,确认使用 mm() 转换
找不到 "Front Plane" 中文版本名称不同 使用 start_sketch(),已内置中英文兼容
SelectByID2("SKETCH") 持续返回 False SW2024 中文版草图名称选择不稳定 改用 with sketch(...) 或 end_sketch() 返回值

完整排错手册(含错误码对照表)见 references/troubleshooting.md。


下一步:从单件建模拓展到批量与装配

完成基础 5 步后,推荐按以下顺序继续探索:

示例文件 学习重点
examples/02_complex_part.py 多草图、切除拉伸(孔)、倒角
examples/03_assembly.py 装配体:添加组件、配合关系
examples/04_batch_export.py 批量导出 STEP,错误处理
examples/05_drawing.py 工程图:三视图、尺寸标注、PDF 导出
examples/08_mini_fan_motion_assembly.py 多零件装配 + Motion Study 运动算例

所有 API 参考文档位于 references/ 目录,每个功能模块都有独立说明。

🚀 进阶提示:如果希望用自然语言描述需求自动生成建模计划,可以探索 subskills/solidworks-vibecad/SKILL.md,将设计需求自动转换为参数化执行计划并走制造规则检查。


总结

步骤 核心函数 作用
1 connect_solidworks() 连接 SolidWorks 实例
2 new_document(sw, "part") 新建零件文档
3 start_sketch() → sketch_circle() → end_sketch() 绘制圆形草图
4 extrude_boss(model, "Sketch1", mm(50)) 拉伸成 50mm 实体
5 save_document() + export_to_step() 保存原生文件并导出 STEP

SolidWorks Automation Skill 把 COM 接口的复杂细节封装在底层,你只需要关心"画什么、拉多远、存哪里"。配合 scripts/sw_preflight.py 的环境自检和 scripts/sw_review.py 的多视角自审查,整个建模流程既高效,也有交付保障。

登录后查看全文
solidworks-automation-skill