简介本资源是一套面向机械设计工程师、CAD开发人员及高校相关专业学习者的SolidWorks二次开发入门与进阶实战素材包聚焦API编程、COM接口调用与插件定制等核心能力培养助力用户突破标准化设计瓶颈实现参数化建模、ERP数据对接、自动化仿真验证等企业级应用。压缩包为RAR格式大小54.08MB虽未提供具体文件列表但结合描述可知内容覆盖API基础类库说明、C#与VBA双语言示例代码、Visual Studio开发环境配置指南、典型应用场景如特征库构建、工程图批量生成的完整实现逻辑及错误处理与性能优化实践要点。已有585人学习下载资源结构兼顾理论框架与可运行代码片段特别适合从零起步掌握SolidWorks定制开发并快速迁移到实际项目中的中初级开发者。1. SolidWorks二次开发不是“写个宏就完事”而是让设计系统听你指挥的工程实践很多刚接触SolidWorks二次开发的工程师第一反应是打开VBA编辑器录个宏、改两行代码以为这就叫“开发”。但真实场景远比这复杂某汽车零部件厂用C#插件自动校验200个装配干涉项把人工检查从4小时压缩到17秒某风电企业将SolidWorks与内部PLM系统打通每次保存零件时自动触发BOM生成、版本归档和审批流推送还有团队用COM接口批量重建焊件结构树解决GB型材库导入后特征丢失问题。这些不是脚本级操作而是嵌入设计流程底层的系统级集成。SolidWorks二次开发的本质是通过API接管软件核心对象生命周期——从Document创建、Feature重建、Sketch几何约束求解到Drawing视图投影、Configuration切换、PropertyManagerPage交互响应。它要求开发者既懂机械设计逻辑比如特征建模顺序对重建失败的影响又熟悉COM互操作机制如SwApp对象的线程模型限制还要处理SolidWorks主进程的稳定性边界例如避免在OnIdle事件中执行耗时计算。适合两类人一是有3年以上SolidWorks实操经验、能准确描述“为什么这个Feature重建会失败”的资深设计师二是熟悉.NET或C内存管理、能看懂IDispatch接口定义的开发工程师。两者缺一不可。2. COM接口调用不是调用普通DLL理解ISwModel与SwApp的生命周期绑定关系2.1 SolidWorks API的COM本质决定了开发语言选择边界SolidWorks API并非标准.NET类库而是基于Windows COM组件模型暴露的类型库swconst.tlb、swassembly.tlb等。这意味着所有调用都必须经过COM互操作层COM Interop其核心约束直接决定技术选型VBA仅限于宏录制与简单逻辑因运行在SolidWorks进程内无需跨进程通信但无法引用外部.NET库且调试能力极弱C#/.NET Framework主流选择需引用SolidWorks.Interop.sldworks.dll等互操作程序集该DLL由tlbimp.exe生成封装了COM接口的托管包装器C/ATL性能最优可直接调用IUnknown接口但需手动管理引用计数、处理HRESULT返回值且VS项目配置复杂VB.NET语法友好但已逐步被C#替代社区支持度下降。提示SolidWorks 2020及以后版本默认禁用.NET Core/.NET 5因COM互操作层依赖.NET Framework 4.7.2的特定实现。若强行使用.NET 6需通过Microsoft.Win32.RegistrationServices注册类型库且部分接口如ISwDrawing::CreateDrawViewFromModelView3会抛出InvalidCastException。2.2 SwApp对象获取是所有开发的起点但极易踩坑获取SolidWorks主应用程序对象SldWorks看似简单实则暗藏陷阱。以下代码是常见错误写法// ❌ 错误未检查SolidWorks是否已运行且未处理COM异常 SldWorks swApp new SldWorks(); ModelDoc2 model swApp.ActiveDoc as ModelDoc2;正确做法必须包含三重校验// ✅ 正确显式获取、空值检查、异常捕获 SldWorks swApp null; try { // 尝试获取已运行实例CLSID: {83A33D31-27C5-11CE-BFD4-00400513BB57} swApp (SldWorks)Marshal.GetActiveObject(SldWorks.Application); } catch (COMException ex) when (ex.ErrorCode unchecked((int)0x800401E3)) { // CLASS_NOT_AVAILABLESolidWorks未启动 MessageBox.Show(请先启动SolidWorks); return; } catch (COMException ex) when (ex.ErrorCode unchecked((int)0x800401E4)) { // OPERATION_UNAVAILABLE权限不足如以管理员身份运行VS但SolidWorks非管理员 MessageBox.Show(请确保SolidWorks与开发环境运行权限一致); return; } // 检查是否获取成功且文档已打开 if (swApp null || swApp.ActiveDoc null) { MessageBox.Show(未检测到活动文档请打开一个零件/装配体/工程图); return; } ModelDoc2 model swApp.ActiveDoc; // ⚠️ 关键必须检查model类型避免在Drawing文档上调用Part特有方法 if (model.GetType() ! typeof(PartDoc)) { MessageBox.Show($当前文档类型为{model.GetType().Name}本插件仅支持零件文档); return; }2.2.1 SwApp对象的线程模型限制为什么不能在后台线程调用APISolidWorks API强制要求所有调用必须在STASingle-Threaded Apartment线程中执行。若在Task.Run或ThreadPool线程中调用swApp.NewDocument2会立即抛出COMException错误码0x8001010ERPC_E_WRONG_THREAD。解决方案只有两种方案1推荐使用Control.Invoke委托到UI线程WinForms/WPFprivate void OnButtonClick(object sender, EventArgs e) { // 在UI线程中调用 var result swApp.Invoke(new Funcbool(() { try { ModelDoc2 newPart swApp.NewDocument2(C:\\Program Files\\SOLIDWORKS Corp\\SOLIDWORKS\\templates\\part.prtdot, (int)swDocumentTypes_e.swDocPART, 0, 0); return newPart ! null; } catch (Exception ex) { MessageBox.Show($创建失败{ex.Message}); return false; } })); }方案2为后台任务显式创建STA线程适用于长时间运算Thread workerThread new Thread(() { // 设置线程为STA Thread.CurrentThread.SetApartmentState(ApartmentState.STA); try { // 在此线程中获取SwApp并执行操作 SldWorks swApp (SldWorks)Marshal.GetActiveObject(SldWorks.Application); // ... 执行耗时操作 } catch (COMException ex) { // 处理COM异常 } }); workerThread.Start();2.2.2 ISwModel接口的隐式释放风险为什么Feature重建后模型变空白ModelDoc2对象即ISwModel在.NET中受GC管理但其底层COM引用计数由SolidWorks进程控制。常见错误是在方法中创建局部ModelDoc2变量方法结束时GC回收导致COM引用计数减1若此时SolidWorks窗口未激活可能触发模型卸载。验证方式调用model.Extension.SelectByID2(Feature1, BODYFEATURE, 0, 0, 0, true, 0, null, 0)后立即model.GraphicsRedraw2()若界面无响应大概率是对象提前释放。安全写法将ModelDoc2声明为窗体级字段并在窗体关闭时显式释放public partial class MyPluginForm : Form { private ModelDoc2 _currentModel; // 窗体级持有引用 public void LoadActiveModel() { _currentModel swApp.ActiveDoc; if (_currentModel null) throw new InvalidOperationException(无活动文档); } protected override void OnFormClosed(FormClosedEventArgs e) { // 显式释放COM对象避免内存泄漏 if (_currentModel ! null) { Marshal.ReleaseComObject(_currentModel); _currentModel null; } base.OnFormClosed(e); } }3. 从VBA宏到C#插件构建可部署的SolidWorks Add-in工程3.1 Visual Studio项目配置的关键参数设置新建Class Library项目后必须调整以下五项配置否则编译通过但运行时崩溃配置项正确值错误后果目标框架.NET Framework 4.7.2SolidWorks 2019或4.6.12017.NET Core导致System.Runtime.InteropServices.COMException平台目标x64SolidWorks 64位或x8632位架构不匹配引发BadImageFormatException注册COM互操作勾选Project Properties → Build → Register for COM interop插件无法被SolidWorks识别输出路径C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\chinese-simplified\中文版插件菜单不显示延迟签名取消勾选否则GAC注册失败RegAsm报错“无法注册类型”注意SolidWorks 2023开始要求插件必须签名。若未配置证书安装时会提示“无法验证发布者”。解决方案是在项目属性→签名页勾选“为ClickOnce清单签名”并指定.pfx证书文件。3.2 实现Add-in入口ISwAddin接口的三个必需方法SolidWorks插件必须实现SwAddin接口SolidWorks.Interop.sldworks.ISwAddin其三个方法构成插件生命周期public class MySolidWorksAddin : SwAddin { private SldWorks _swApp; private CommandGroup _cmdGroup; // ✅ ConnectToSW插件加载时调用必须在此获取SwApp并注册命令 public bool ConnectToSW(object ThisSW, int cookie) { _swApp (SldWorks)ThisSW; _cookie cookie; // 创建自定义命令组工具栏 _cmdGroup _swApp.CreateCommandGroup2( 1, // ID 我的插件, // 标题 MyPlugin, // 工具提示 -1, // 图标索引-1表示内置图标 false, // 是否显示在菜单 ref _cookie); // 添加命令项按钮 _cmdGroup.AddCommandItem2( 生成标准件, // 名称 1, // 命令ID icons\\bolt.ico, // 图标路径相对插件DLL目录 生成螺栓, // 工具提示 点击生成ISO标准螺栓, // 状态栏文本 (int)swCommands_e.swCommands_Custom, // 命令类型 0, // 用户数据 true); // 启用 // 注册命令回调 _cmdGroup.CommandOpen OnCommandOpen; return true; } // ✅ DisconnectFromSW插件卸载时调用必须释放所有COM对象 public bool DisconnectFromSW() { if (_cmdGroup ! null) { Marshal.ReleaseComObject(_cmdGroup); _cmdGroup null; } if (_swApp ! null) { Marshal.ReleaseComObject(_swApp); _swApp null; } return true; } // ✅ GetAddInInfo返回插件元信息SolidWorks据此显示名称和描述 public void GetAddInInfo(ref string Title, ref string Author, ref string Description, ref string Version) { Title 我的SolidWorks插件; Author Your Company; Description 用于自动化标准件生成的插件; Version 1.0.0; } // 命令回调处理 private void OnCommandOpen(int CommandID) { if (_swApp.ActiveDoc is PartDoc part) { // 执行具体逻辑 CreateBolt(part); } } }3.2.1 注册表项配置让SolidWorks在启动时加载你的插件仅编译DLL不够必须向Windows注册表写入插件信息。手动操作易出错推荐使用RegAsm.exe工具# 在Visual Studio Developer Command Prompt中执行 cd /d C:\YourPluginPath C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe MyPlugin.dll /tlb /codebase该命令生成.tlb类型库并写入注册表HKEY_LOCAL_MACHINE\SOFTWARE\SOLIDWORKS\AddIns\{GUID}其中关键值Description插件描述显示在工具→插件列表LoadAtStartupDWORD1启动时自动加载Title插件名称显示在菜单提示若插件在SolidWorks中显示为灰色不可用检查LoadAtStartup值是否为1且注册表路径中的GUID必须与项目AssemblyInfo.cs中[Guid(xxx)]一致。3.3 调试技巧如何在SolidWorks进程中实时断点调试VS默认无法附加到SolidWorks进程需手动配置启用本机代码调试项目属性→调试→勾选“启用本机代码调试”附加到进程调试→附加到进程→选择SLDWORKS.exe注意必须是当前打开SolidWorks文档的进程而非多个同名进程设置断点在ConnectToSW或命令回调方法中设断点触发调试在SolidWorks中点击插件按钮VS自动中断常见调试失败原因VS与SolidWorks运行权限不一致一个管理员一个标准用户.NET Framework版本不匹配VS用4.8SolidWorks用4.7.2插件DLL路径含中文字符注册表写入失败4. 特征自动化实战用C#批量创建GB/T 1167-1996螺纹孔4.1 分析GB螺纹孔建模逻辑为什么不能直接调用InsertHoleWizardGB/T 1167-1996规定螺纹孔需包含沉头孔Counterbore、螺纹Thread、倒角Chamfer三特征且尺寸严格关联。若用FeatureManager::FeatureHoleWzdSolidWorks Hole Wizard默认生成ISO标准无法精确控制GB参数如沉头深度1.5×螺纹大径。必须用底层API逐特征构建特征类型关键参数API调用方式沉头孔直径螺纹大径2mm深度1.5×大径FeatureManager::CreateCircle2FeatureManager::FeatureCutEx2螺纹类型Internal规格GB/T 193FeatureManager::FeatureThread需先创建圆柱面倒角距离0.5mm角度45°FeatureManager::FeatureChamfer24.2 完整代码创建M6×1.0螺纹孔的可复用方法/// summary /// 在指定面上创建GB/T 1167-1996螺纹孔 /// /summary /// param namemodel当前模型/param /// param nameface目标面必须为平面/param /// param namecenterX孔中心X坐标模型坐标系/param /// param namecenterY孔中心Y坐标/param /// param namethreadSize螺纹规格如M6/param public static bool CreateGBT1167ThreadHole(ModelDoc2 model, Face2 face, double centerX, double centerY, string threadSize) { FeatureManager featMgr model.FeatureManager; SelectionMgr selMgr model.SelectionManager; // Step 1: 获取螺纹参数简化版实际应查GB表 double majorDiameter threadSize switch { M6 6.0, M8 8.0, M10 10.0, _ throw new ArgumentException(不支持的螺纹规格) }; // Step 2: 创建沉头孔草图 SketchManager sketchMgr model.CreateDrawnSketch2(face); sketchMgr.CreateCircle(centerX, centerY, 0, centerX majorDiameter/2 1.0, centerY, 0); // 沉头直径 大径2mm sketchMgr.CreateCircle(centerX, centerY, 0, centerX majorDiameter/2, centerY, 0); // 螺纹底孔直径 大径 // Step 3: 拉伸切除沉头孔深度1.5×大径 object[] bodies featMgr.FeatureCutEx2( true, // 薄壁 false, // 保持相交 false, // 合并实体 (int)swEndCondition_e.swEndCondUpToSurface, // 终止条件 0, // 深度 0, // 拔模角度 0, // 拔模方向 0, // 起始偏移 0, // 终止偏移 0, // 薄壁厚度 0, // 薄壁方向 0, // 薄壁拔模 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 ......## 1. SolidWorks二次开发不是“写个宏就完事”而是让设计系统听你指挥的工程实践 很多刚接触SolidWorks二次开发的工程师第一反应是打开VBA编辑器录个宏、改两行代码以为这就叫“开发”。但真实场景远比这复杂某汽车零部件厂用C#插件自动校验200个装配干涉项把人工检查从4小时压缩到17秒某风电企业将SolidWorks与内部PLM系统打通每次保存零件时自动触发BOM生成、版本归档和审批流推送还有团队用COM接口批量重建焊件结构树解决GB型材库导入后特征丢失问题。这些不是脚本级操作而是嵌入设计流程底层的系统级集成。SolidWorks二次开发的本质是通过API接管软件核心对象生命周期——从Document创建、Feature重建、Sketch几何约束求解到Drawing视图投影、Configuration切换、PropertyManagerPage交互响应。它要求开发者既懂机械设计逻辑比如特征建模顺序对重建失败的影响又熟悉COM互操作机制如SwApp对象的线程模型限制还要处理SolidWorks主进程的稳定性边界例如避免在OnIdle事件中执行耗时计算。适合两类人一是有3年以上SolidWorks实操经验、能准确描述“为什么这个Feature重建会失败”的资深设计师二是熟悉.NET或C内存管理、能看懂IDispatch接口定义的开发工程师。两者缺一不可。 ## 2. COM接口调用不是调用普通DLL理解ISwModel与SwApp的生命周期绑定关系 ### 2.1 SolidWorks API的COM本质决定了开发语言选择边界 SolidWorks API并非标准.NET类库而是基于Windows COM组件模型暴露的类型库swconst.tlb、swassembly.tlb等。这意味着所有调用都必须经过COM互操作层COM Interop其核心约束直接决定技术选型 - **VBA**仅限于宏录制与简单逻辑因运行在SolidWorks进程内无需跨进程通信但无法引用外部.NET库且调试能力极弱 - **C#/.NET Framework**主流选择需引用SolidWorks.Interop.sldworks.dll等互操作程序集该DLL由tlbimp.exe生成封装了COM接口的托管包装器 - **C/ATL**性能最优可直接调用IUnknown接口但需手动管理引用计数、处理HRESULT返回值且VS项目配置复杂 - **VB.NET**语法友好但已逐步被C#替代社区支持度下降。 提示SolidWorks 2020及以后版本默认禁用.NET Core/.NET 5因COM互操作层依赖.NET Framework 4.7.2的特定实现。若强行使用.NET 6需通过Microsoft.Win32.RegistrationServices注册类型库且部分接口如ISwDrawing::CreateDrawViewFromModelView3会抛出InvalidCastException。 ### 2.2 SwApp对象获取是所有开发的起点但极易踩坑 获取SolidWorks主应用程序对象SldWorks看似简单实则暗藏陷阱。以下代码是常见错误写法 csharp // ❌ 错误未检查SolidWorks是否已运行且未处理COM异常 SldWorks swApp new SldWorks(); ModelDoc2 model swApp.ActiveDoc as ModelDoc2;正确做法必须包含三重校验// ✅ 正确显式获取、空值检查、异常捕获 SldWorks swApp null; try { // 尝试获取已运行实例CLSID: {83A33D31-27C5-11CE-BFD4-00400513BB57} swApp (SldWorks)Marshal.GetActiveObject(SldWorks.Application); } catch (COMException ex) when (ex.ErrorCode unchecked((int)0x800401E3)) { // CLASS_NOT_AVAILABLESolidWorks未启动 MessageBox.Show(请先启动SolidWorks); return; } catch (COMException ex) when (ex.ErrorCode unchecked((int)0x800401E4)) { // OPERATION_UNAVAILABLE权限不足如以管理员身份运行VS但SolidWorks非管理员 MessageBox.Show(请确保SolidWorks与开发环境运行权限一致); return; } // 检查是否获取成功且文档已打开 if (swApp null || swApp.ActiveDoc null) { MessageBox.Show(未检测到活动文档请打开一个零件/装配体/工程图); return; } ModelDoc2 model swApp.ActiveDoc; // ⚠️ 关键必须检查model类型避免在Drawing文档上调用Part特有方法 if (model.GetType() ! typeof(PartDoc)) { MessageBox.Show($当前文档类型为{model.GetType().Name}本插件仅支持零件文档); return; }2.2.1 SwApp对象的线程模型限制为什么不能在后台线程调用APISolidWorks API强制要求所有调用必须在STASingle-Threaded Apartment线程中执行。若在Task.Run或ThreadPool线程中调用swApp.NewDocument2会立即抛出COMException错误码0x8001010ERPC_E_WRONG_THREAD。解决方案只有两种方案1推荐使用Control.Invoke委托到UI线程WinForms/WPFprivate void OnButtonClick(object sender, EventArgs e) { // 在UI线程中调用 var result swApp.Invoke(new Funcbool(() { try { ModelDoc2 newPart swApp.NewDocument2(C:\\Program Files\\SOLIDWORKS Corp\\SOLIDWORKS\\templates\\part.prtdot, (int)swDocumentTypes_e.swDocPART, 0, 0); return newPart ! null; } catch (Exception ex) { MessageBox.Show($创建失败{ex.Message}); return false; } })); }方案2为后台任务显式创建STA线程适用于长时间运算Thread workerThread new Thread(() { // 设置线程为STA Thread.CurrentThread.SetApartmentState(ApartmentState.STA); try { // 在此线程中获取SwApp并执行操作 SldWorks swApp (SldWorks)Marshal.GetActiveObject(SldWorks.Application); // ... 执行耗时操作 } catch (COMException ex) { // 处理COM异常 } }); workerThread.Start();2.2.2 ISwModel接口的隐式释放风险为什么Feature重建后模型变空白ModelDoc2对象即ISwModel在.NET中受GC管理但其底层COM引用计数由SolidWorks进程控制。常见错误是在方法中创建局部ModelDoc2变量方法结束时GC回收导致COM引用计数减1若此时SolidWorks窗口未激活可能触发模型卸载。验证方式调用model.Extension.SelectByID2(Feature1, BODYFEATURE, 0, 0, 0, true, 0, null, 0)后立即model.GraphicsRedraw2()若界面无响应大概率是对象提前释放。安全写法将ModelDoc2声明为窗体级字段并在窗体关闭时显式释放public partial class MyPluginForm : Form { private ModelDoc2 _currentModel; // 窗体级持有引用 public void LoadActiveModel() { _currentModel swApp.ActiveDoc; if (_currentModel null) throw new InvalidOperationException(无活动文档); } protected override void OnFormClosed(FormClosedEventArgs e) { // 显式释放COM对象避免内存泄漏 if (_currentModel ! null) { Marshal.ReleaseComObject(_currentModel); _currentModel null; } base.OnFormClosed(e); } }3. 从VBA宏到C#插件构建可部署的SolidWorks Add-in工程3.1 Visual Studio项目配置的关键参数设置新建Class Library项目后必须调整以下五项配置否则编译通过但运行时崩溃配置项正确值错误后果目标框架.NET Framework 4.7.2SolidWorks 2019或4.6.12017.NET Core导致System.Runtime.InteropServices.COMException平台目标x64SolidWorks 64位或x8632位架构不匹配引发BadImageFormatException注册COM互操作勾选Project Properties → Build → Register for COM interop插件无法被SolidWorks识别输出路径C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\chinese-simplified\中文版插件菜单不显示延迟签名取消勾选否则GAC注册失败RegAsm报错“无法注册类型”注意SolidWorks 2023开始要求插件必须签名。若未配置证书安装时会提示“无法验证发布者”。解决方案是在项目属性→签名页勾选“为ClickOnce清单签名”并指定.pfx证书文件。3.2 实现Add-in入口ISwAddin接口的三个必需方法SolidWorks插件必须实现SwAddin接口SolidWorks.Interop.sldworks.ISwAddin其三个方法构成插件生命周期public class MySolidWorksAddin : SwAddin { private SldWorks _swApp; private CommandGroup _cmdGroup; // ✅ ConnectToSW插件加载时调用必须在此获取SwApp并注册命令 public bool ConnectToSW(object ThisSW, int cookie) { _swApp (SldWorks)ThisSW; _cookie cookie; // 创建自定义命令组工具栏 _cmdGroup _swApp.CreateCommandGroup2( 1, // ID 我的插件, // 标题 MyPlugin, // 工具提示 -1, // 图标索引-1表示内置图标 false, // 是否显示在菜单 ref _cookie); // 添加命令项按钮 _cmdGroup.AddCommandItem2( 生成标准件, // 名称 1, // 命令ID icons\\bolt.ico, // 图标路径相对插件DLL目录 生成螺栓, // 工具提示 点击生成ISO标准螺栓, // 状态栏文本 (int)swCommands_e.swCommands_Custom, // 命令类型 0, // 用户数据 true); // 启用 // 注册命令回调 _cmdGroup.CommandOpen OnCommandOpen; return true; } // ✅ DisconnectFromSW插件卸载时调用必须释放所有COM对象 public bool DisconnectFromSW() { if (_cmdGroup ! null) { Marshal.ReleaseComObject(_cmdGroup); _cmdGroup null; } if (_swApp ! null) { Marshal.ReleaseComObject(_swApp); _swApp null; } return true; } // ✅ GetAddInInfo返回插件元信息SolidWorks据此显示名称和描述 public void GetAddInInfo(ref string Title, ref string Author, ref string Description, ref string Version) { Title 我的SolidWorks插件; Author Your Company; Description 用于自动化标准件生成的插件; Version 1.0.0; } // 命令回调处理 private void OnCommandOpen(int CommandID) { if (_swApp.ActiveDoc is PartDoc part) { // 执行具体逻辑 CreateBolt(part); } } }3.2.1 注册表项配置让SolidWorks在启动时加载你的插件仅编译DLL不够必须向Windows注册表写入插件信息。手动操作易出错推荐使用RegAsm.exe工具# 在Visual Studio Developer Command Prompt中执行 cd /d C:\YourPluginPath C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe MyPlugin.dll /tlb /codebase该命令生成.tlb类型库并写入注册表HKEY_LOCAL_MACHINE\SOFTWARE\SOLIDWORKS\AddIns\{GUID}其中关键值Description插件描述显示在工具→插件列表LoadAtStartupDWORD1启动时自动加载Title插件名称显示在菜单提示若插件在SolidWorks中显示为灰色不可用检查LoadAtStartup值是否为1且注册表路径中的GUID必须与项目AssemblyInfo.cs中[Guid(xxx)]一致。3.3 调试技巧如何在SolidWorks进程中实时断点调试VS默认无法附加到SolidWorks进程需手动配置启用本机代码调试项目属性→调试→勾选“启用本机代码调试”附加到进程调试→附加到进程→选择SLDWORKS.exe注意必须是当前打开SolidWorks文档的进程而非多个同名进程设置断点在ConnectToSW或命令回调方法中设断点触发调试在SolidWorks中点击插件按钮VS自动中断常见调试失败原因VS与SolidWorks运行权限不一致一个管理员一个标准用户.NET Framework版本不匹配VS用4.8SolidWorks用4.7.2插件DLL路径含中文字符注册表写入失败4. 特征自动化实战用C#批量创建GB/T 1167-1996螺纹孔4.1 分析GB螺纹孔建模逻辑为什么不能直接调用InsertHoleWizardGB/T 1167-1996规定螺纹孔需包含沉头孔Counterbore、螺纹Thread、倒角Chamfer三特征且尺寸严格关联。若用FeatureManager::FeatureHoleWzdSolidWorks Hole Wizard默认生成ISO标准无法精确控制GB参数如沉头深度1.5×螺纹大径。必须用底层API逐特征构建特征类型关键参数API调用方式沉头孔直径螺纹大径2mm深度1.5×大径FeatureManager::CreateCircle2FeatureManager::FeatureCutEx2螺纹类型Internal规格GB/T 193FeatureManager::FeatureThread需先创建圆柱面倒角距离0.5mm角度45°FeatureManager::FeatureChamfer24.2 完整代码创建M6×1.0螺纹孔的可复用方法/// summary /// 在指定面上创建GB/T 1167-1996螺纹孔 /// /summary /// param namemodel当前模型/param /// param nameface目标面必须为平面/param /// param namecenterX孔中心X坐标模型坐标系/param /// param namecenterY孔中心Y坐标/param /// param namethreadSize螺纹规格如M6/param public static bool CreateGBT1167ThreadHole(ModelDoc2 model, Face2 face, double centerX, double centerY, string threadSize) { FeatureManager featMgr model.FeatureManager; SelectionMgr selMgr model.SelectionManager; // Step 1: 获取螺纹参数简化版实际应查GB表 double majorDiameter threadSize switch { M6 6.0, M8 8.0, M10 10.0, _ throw new ArgumentException(不支持的螺纹规格) }; // Step 2: 创建沉头孔草图 SketchManager sketchMgr model.CreateDrawnSketch2(face); sketchMgr.CreateCircle(centerX, centerY, 0, centerX majorDiameter/2 1.0, centerY, 0); // 沉头直径 大径2mm sketchMgr.CreateCircle(centerX, centerY, 0, centerX majorDiameter/2, centerY, 0); // 螺纹底孔直径 大径 // Step 3: 拉伸切除沉头孔深度1.5×大径 object[] bodies featMgr.FeatureCutEx2( true, // 薄壁 false, // 保持相交 false, // 合并实体 (int)swEndCondition_e.swEndCondUpToSurface, // 终止条件 0, // 深度 0, // 拔模角度 0, // 拔模方向 0, // 起始偏移 0, // 终止偏移 0, // 薄壁厚度 0, // 薄壁方向 0, // 薄壁拔模 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 0, // 薄壁终止偏移 0, // 薄壁拔模角度 0, // 薄壁拔模方向 0, // 薄壁起始偏移 ...... // 此处省略大量参数实际需按API文档填满 ); // ⚠️ 关键FeatureCutEx2参数极多必须严格按顺序传入。推荐使用封装方法 // var cutFeat featMgr.FeatureCut(true, false, false, 0, majorDiameter * 1.5, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, ............); // 但更推荐先用宏录制再提取参数序列 return true; }4.2.1 参数表FeatureCutEx2关键参数含义按SolidWorks API文档参数索引参数名典型值说明0Bosstrue是否为凸台特征false为切除1FromswStartSketchPlane起始面类型2Depth9.0拉伸深度M6时6×1.53UpToSurfacenull终止面若为null则用深度4FlipSideToCutfalse是否反向切除5Mergetrue是否合并到主体6UseFeatScopefalse是否使用特征范围7FeatScopeArraynull特征范围数组提示FeatureCutEx2有58个参数实际开发中建议用FeatureCut简化版仅12参数或通过MacroRecorder录制操作后提取参数——这是最可靠的参数获取方式。4.3 排错指南重建失败的三大高频原因及验证方法当调用model.EditRebuild3()后模型变空白或报错按以下顺序排查现象可能原因验证方法解决方案重建后特征消失草图未完全定义欠约束在SolidWorks中右键草图→“显示/删除几何关系”检查是否标红添加sketch.AddGeometricRelation2(Line1,Line2, (int)swDimensionType_e.swDimensionType_Perpendicular)FeatureManager::FeatureCut返回null切除方向错误如在实体内部创建负空间用model.Extension.SelectByID2(Face1Part1, FACE, 0,0,0, false, 0, null, 0)手动选面验证调整FlipSideToCut参数为true调用Thread时崩溃未先创建圆柱面作为螺纹基体在FeatureManager中查看特征树确认存在圆柱面先用FeatureManager::FeatureExtrude2创建圆柱再在其面上调用FeatureThread终极验证法在代码中插入日志输出当前状态// 输出当前活动文档类型和特征数 Debug.WriteLine($文档类型: {model.GetType().Name}, 特征数: {model.FeatureCount}); // 输出最后创建的特征名称 Feature lastFeat model.FirstFeature(); while (lastFeat.GetNext() ! null) lastFeat lastFeat.GetNext(); Debug.WriteLine($最后特征: {lastFeat.Name});5. 进阶技巧用PropertyManagerPage构建专业级交互界面5.1 为什么不用WinForms而用PropertyManagerPageWinForms窗体在SolidWorks中会遮挡模型视图且无法响应SolidWorks的实时事件如旋转模型时窗体不跟随。PropertyManagerPage是SolidWorks原生UI框架其优势在于深度集成可嵌入SolidWorks属性管理器面板右侧与FeatureManager树同级事件驱动支持OnButtonPress、OnGroupExpand、OnSelectionBoxCallout等20事件智能选择SelectionBox控件可限定用户只能选择特定类型对象如“仅平面”、“仅边线”状态保持关闭后自动保存用户输入下次打开恢复上次值。5.2 创建GB螺纹孔配置面板的完整流程public class ThreadHolePMP : PropertyManagerPage2 { private SldWorks _swApp; private ModelDoc2 _model; private SelectionMgr _selMgr; public ThreadHolePMP(SldWorks swApp) { _swApp swApp; _model swApp.ActiveDoc; _selMgr _model.SelectionManager; } public void Show() { // 创建PropertyManagerPage PropertyManagerPage2 pmp _swApp.CreatePropertyManagerPage( GB螺纹孔配置, (int)swPropertyManagerPageOptions_e.swPropertyManagerPageOptions_OkayButton | (int)swPropertyManagerPageOptions_e.swPropertyManagerPageOptions_CancelButton, this, null); // 添加选择框仅允许选择平面 pmp.AddSelectionBox( 选择基准面, 请选择一个平面作为螺纹孔定位面, (int)swSelectType_e.swSelFACES, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, ...... p a hrefhttps://download.csdn.net/download/weixin_42683392/27399368 stylecolor:#ec7500;font-size:14px; 本文还有配套的精品资源点击获取 /a img altmenu-r.4af5f7ec.gif srchttps://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif stylewidth:16px;margin-left:4px;vertical-align:text-bottom;cursor:text; /p
