Python 通过 SolidWorks API (应用程序编程接口) 来控制 SolidWorks 软件,实现自动化操作和二次开发。

核心概念：SolidWorks API 和 pywin32

1. SolidWorks API (SOLIDWORKS API)

   • 这是由 SolidWorks 官方提供的一套接口，允许外部程序（如 Python）通过编程方式访问和操作 SolidWorks 的几乎所有功能。
   • 它是一个基于 COM (Component Object Model) 的技术，主要面向 Windows 平台。
   • 你可以把它想象成 SolidWorks 的“遥控器”或“控制台”，通过发送特定的“指令”（方法/函数）来让 SolidWorks 执行操作，如创建草图、拉伸特征、修改尺寸、获取属性等。

2. pywin32 (Python for Windows Extensions)

   • Python 本身是跨平台的，但 SolidWorks API 是 Windows 特有的，我们需要一个桥梁来让 Python 能够调用 Windows 的 COM 组件。
   • pywin32 就是这座桥梁，它是一个 Python 库，提供了对 Windows API 和 COM 对象的访问能力。
   • 在使用 SolidWorks API 之前，必须先安装 pywin32。

准备工作：环境搭建

在开始编写代码之前,请确保你的电脑上安装了以下软件：

1. SolidWorks：确保已安装，推荐较新版本，因为 API 功能会更完善。
2. Python：建议使用 Python 3.x 版本。
3. pywin32：通过 pip 安装。

   pip install pywin32

如何开始：连接到 SolidWorks

所有操作的起点都是获取 SolidWorks 应用程序对象的引用。

import win32com.client
# 1. 创建 SolidWorks 应用程序对象
# Dispatch 会启动一个 SolidWorks 实例
sw_app = win32com.client.Dispatch("SldWorks.Application")
# 2. 让 SolidWorks 窗口可见 (可选，但推荐)
sw_app.Visible = True
# 3. 获取其他重要对象的引用 (文档模型、模型视图等)
# sw_app: 代表整个 SolidWorks 应用程序
# sw_doc: 代表当前打开的文档 (零件、装配体或工程图)
# sw_model: 代表文档的模型数据 (零件或装配体)
# sw_model_view: 代表模型的视图
# 获取活动文档
sw_doc = sw_app.ActiveDoc
if sw_doc is None:
    print("请先在 SolidWorks 中打开一个文件！")
    exit()
print(f"成功连接到 SolidWorks，当前打开的文件是: {sw_doc.GetTitle()}")

常用操作示例

以下是一些常见的自动化任务代码示例。

示例 1：获取并修改零件尺寸

假设你有一个简单的拉伸零件,你想修改其拉伸高度。

import win32com.client
# 连接到 SolidWorks (同上)
sw_app = win32com.client.Dispatch("SldWorks.Application")
sw_app.Visible = True
sw_doc = sw_app.ActiveDoc
if not sw_doc:
    print("请先打开一个零件文件！")
    exit()
# 获取模型
sw_model = sw_doc.Model
# 获取特征管理器树
sw_feat_mgr = sw_model.FeatureManager
# 假设我们想修改第一个拉伸特征的深度
# 注意：遍历特征通常使用 GetFeatureBy... 方法
# 这里我们简化，假设第一个特征就是我们要的拉伸特征
# 更稳健的做法是遍历所有特征，通过名称或类型找到目标特征
#  sw_feat = sw_feat_mgr.GetFeatureByName("拉伸1")
# 获取第一个特征 (这是一个示例，实际中需要更精确的定位)
sw_feat = sw_feat_mgr.GetFirstFeature()
while sw_feat:
    # 检查特征类型，拉伸特征的类型是 2
    if sw_feat.GetTypeName2() == "凸台-拉伸":
        print(f"找到拉伸特征: {sw_feat.Name}")
        # 获取特征的数据对象
        sw_feat_data = sw_feat.GetDefinition()
        # 对于拉伸特征，其定义是一个拉伸对象
        # 我们可以访问其方向和深度
        # 注意：API 操作非常依赖对象模型，需要查阅官方文档
        # 一个更简单的方法是获取特征下的尺寸
        # 尺寸通常位于特征下的草图或“从...”等位置
        # 这里我们假设深度尺寸可以直接获取
        # 这是一个简化的例子，实际情况可能更复杂
        # 获取特征的尺寸
        dim = sw_feat.GetFirstDimension()
        if dim:
            print(f"当前尺寸名称: {dim.Name}, 当前值: {dim.SystemValue}")
            # 修改尺寸值 (单位为米)
            new_value = 0.05  # 50mm
            dim.SystemValue = new_value
            print(f"已将尺寸修改为: {new_value} 米")
            # 更新模型以应用更改
            sw_doc.ForceRebuild3(True)
            sw_doc.EditRebuild()
            break  # 找到并修改后退出循环
    # 移动到下一个特征
    sw_feat = sw_feat.GetNextFeature()
print("操作完成。")

示例 2：批量重命名零件特征

这个脚本可以遍历一个零件的所有特征,并按照特定规则重命名它们。

import win32com.client
sw_app = win32com.client.Dispatch("SldWorks.Application")
sw_app.Visible = True
sw_doc = sw_app.ActiveDoc
if not sw_doc:
    print("请先打开一个零件文件！")
    exit()
sw_model = sw_doc.Model
sw_feat_mgr = sw_model.FeatureManager
sw_feat = sw_feat_mgr.GetFirstFeature()
feature_count = 0
while sw_feat:
    feature_count += 1
    old_name = sw_feat.Name
    # 新命名规则: "Feature_序号_原名"
    new_name = f"FEAT_{feature_count}_{old_name}"
    # 特征重命名方法
    # 注意：并非所有特征都可以直接重命名，某些系统特征（如坐标系、基准面）可能不允许
    try:
        if sw_feat.Name2 != "": # 确保特征有可用的名称
            sw_feat.Name = new_name
            print(f"已重命名: '{old_name}' -> '{new_name}'")
    except Exception as e:
        print(f"无法重命名特征 '{old_name}': {e}")
    sw_feat = sw_feat.GetNextFeature()
print(f"批量重命名完成，共处理了 {feature_count} 个特征。")

示例 3：获取零件的质量属性

这个脚本可以计算并输出当前零件的质量、体积、重心等信息。

import win32com.client
sw_app = win32com.client.Dispatch("SldWorks.Application")
sw_app.Visible = True
sw_doc = sw_app.ActiveDoc
if not sw_doc:
    print("请先打开一个零件文件！")
    exit()
# 获取质量属性对象
sw_mass_prop = sw_doc.Extension.get_MassProperties2(True) # True 表示计算精确值，但较慢
if sw_mass_prop:
    print("--- 零件质量属性 ---")
    print(f"质量: {sw_mass_prop.Mass:.4f} kg")
    print(f"体积: {sw_mass_prop.Volume:.4f} mm³")
    print(f"重心 X: {sw_mass_prop.CenterOfMass[0]:.4f} mm")
    print(f"重心 Y: {sw_mass_prop.CenterOfMass[1]:.4f} mm")
    print(f"重心 Z: {sw_mass_prop.CenterOfMass[2]:.4f} mm")
    print(f"惯性矩 (Ixx): {sw_mass_prop MomentsOfInertia[0]:.4f} kg*mm²")
    print("--------------------")
else:
    print("无法获取质量属性。")

SolidWorks API 的学习资源

SolidWorks API 非常庞大，学习曲线较陡峭,以下是一些关键资源：

1. SolidWorks API 帮助文件 (SOLIDWORKS API Help)：

   • 这是最权威、最重要的资源，在 SolidWorks 安装目录下可以找到，或者在 SolidWorks 中通过 工具 -> 宏 -> 宏编辑器，然后按 F1 打开。
   • 它包含了所有对象、方法、属性的详细说明和代码示例。

2. 宏录制器：

   • 这是学习 API 最快的方法！
   • 在 SolidWorks 中，工具 -> 宏 -> 录制...，然后手动执行你想要自动化的操作（如创建一个圆、拉伸一个特征）。
   • 停止录制后，你可以查看生成的 VBA 宏代码，这些代码就是调用 API 的真实示例，你可以直接将其翻译成 Python。

3. 在线社区和论坛：

   • SolidWorks 论坛：有专门的 API 板块,可以提问和搜索问题。
   • Stack Overflow：搜索 python-sldworks 或 solidworks-api
   • GitHub：搜索 python-sldworks 或 sw-api,有很多开源项目和示例代码。

4. 第三方库 sldworks：

   • 有一个名为 sldworks 的非官方 Python 封装库，它试图简化原生 API 的调用方式，使其更“Pythonic”。
   • 你可以尝试安装和使用它：pip install sldworks。
   • 优点：语法更简洁,易于上手。
   • 缺点：可能不是 100% 覆盖所有 API 功能，更新可能滞后于 SolidWorks 新版本。