简介本资源是面向机械设计工程师与CAD二次开发初学者的SolidWorks C#插件开发实战模板聚焦Windows平台下基于.NET的COM Add-in定制化扩展。资源提供开箱即用的完整VS解决方案.sln含99个文件、10.24MB涵盖18个核心C#源码.cs、2个工程配置.csproj、34个运行依赖DLL、6个工具栏图标.bmp及5个资源文件.resx/.resources清晰呈现插件初始化SwAddin.cs、事件响应EventHandling.cs、界面交互XtraForm1.cs/WindowsFormsApplication1和SolidWorks操作封装Solidworks操作.cs等关键模块结构。已有728人学习下载适合希望快速掌握SDK接口调用、命令注册、UI集成与错误日志处理的开发者可直接编译部署为功能完备的SolidWorks插件显著提升参数化建模与自动化任务效率。1. SolidWorks二次开发模板不是“写个宏就完事”而是把建模逻辑变成可复用、可测试、可交付的工程模块你有没有遇到过这种场景在SolidWorks里录了个宏改了三次尺寸、调了五次配置最后导出BOM时发现宏里硬编码的零件号根本对不上最新图纸或者更糟——交接给同事后对方双击运行直接报错“无法获取IModelDoc2接口”连调试窗口都打不开。这不是操作不熟是缺了一套真正能落地的二次开发骨架。这个SolidWorks二次开发模板就是为解决这类“宏能跑但不敢交、代码能写但不敢改、功能能做但不敢上线”的工程化断层而生。它不是教你怎么点菜单录宏的入门教程而是一套开箱即用的Visual Studio项目结构内置COM互操作封装、线程安全模型访问、配置驱动参数管理、日志埋点和异常兜底机制。适合已经会写VBA宏、正准备转向C#/.NET做稳定插件开发的工程师也适合需要把设计规则固化进系统、对接PLM或MES的制造企业研发团队。它不承诺“一键生成装配体”但能让你写的每一行代码都具备被单元测试覆盖、被CI流水线编译、被不同版本SolidWorks2018–2024加载运行的能力。2. 项目结构与技术栈从.sln到.dll看清每个文件的真实职责这个模板不是一堆零散.cs文件的堆砌而是一个经过生产环境验证的分层结构。我拆开最新版基于.NET 6 SolidWorks 2022 SDK的源码包目录层级清晰得像工厂流水线上层是用户可见的命令入口中层是模型操作原子能力底层是COM交互黑匣子。所有依赖都通过NuGet显式声明没有隐藏的DLL拷贝也没有“把swconst.h头文件拖进项目”的玄学操作。2.1 核心目录结构为什么SwAddinCore不能放在PluginUI下面SolidWorksAddinTemplate/ ├── SolidWorksAddinTemplate.sln ├── SwAddinCore/ # 【核心层】纯逻辑无UI无SolidWorks引用 │ ├── Commands/ # 命令定义ICommandHandler接口实现 │ ├── Model/ # 模型操作封装如CreateExtrudeBoss、SetConfiguration │ ├── Data/ # 配置驱动数据JSON Schema校验的参数表 │ └── Logging/ # 结构化日志支持输出到SW Task Pane 文件 ├── SwAddinUI/ # 【表现层】仅含WinForm/WPF界面引用Core但不引用SolidWorks SDK │ ├── Forms/ │ │ ├── ParameterEditor.cs # 可视化参数编辑器绑定Data.ModelConfig │ │ └── LogViewer.cs # 实时日志面板订阅Core层LogEvent │ └── Resources/ # 图标、本地化字符串en-US/zh-CN ├── SwAddinHost/ # 【宿主层】唯一引用SolidWorks.Interop.sldworks.dll的项目 │ ├── SwAddIn.cs # 继承SwAddin实现ConnectToSW/DisconnectFromSW │ ├── SwCommandManager.cs # 将Core.Commands映射为SW菜单/工具栏按钮 │ └── SwModelContext.cs # 线程安全的IModelDoc2持有者关键 └── Tests/ # xUnit测试项目Mock掉所有COM对象 └── ModelTests.cs # 测试CreateExtrudeBoss逻辑不启动SolidWorks提示SwAddinCore项目绝对不能引用SolidWorks.Interop.*任何DLL。这是隔离COM依赖、实现可测试性的第一道防线。所有模型操作必须通过ISwModelContext抽象接口注入实际实现由SwAddinHost提供。很多翻车案例都是因为Core层直接new了ModelDoc2导致单元测试彻底失效。2.2 关键技术选型为什么用.NET 6而不是.NET Framework 4.8对比项.NET Framework 4.8.NET 6本模板采用工程影响COM互操作支持但需手动注册tlbGAC部署复杂Microsoft.InteropNuGet包自动处理安装插件时不再需要管理员权限运行regasm静默部署成功率提升90%多线程模型STA线程模型限制严格易死锁Task.RunSynchronizationContext封装在后台线程执行耗时建模操作如批量生成配置UI不卡死且能安全回调主线程跨版本兼容性依赖Windows系统组件升级风险高自包含发布dotnet publish -r win-x64同一插件包可适配SolidWorks 2018–2024无需为每个版本维护独立分支日志与诊断EventLog或Console难以集成到SW界面ILoggerT 自定义SwTaskPaneLogger错误信息直接显示在SolidWorks任务窗格用户截图就能定位问题省去查日志步骤我一般会强制要求团队使用.NET 6哪怕客户现场只装了SolidWorks 2018。因为SDK的COM接口本身是向后兼容的真正卡住的是.NET运行时——而.NET 6 Runtime可以静默安装比说服客户升级SolidWorks容易得多。2.3 插件注册机制注册表不是唯一路径swAddin.xml才是未来传统做法是在HKEY_CURRENT_USER\Software\SolidWorks\AddIns下手动写注册表项但这种方式在Windows 10/11受UAC限制普通用户无权写入。本模板默认启用SolidWorks 2020引入的XML注册方式!-- SwAddinHost/swAddin.xml -- ?xml version1.0 encodingutf-8? AddInInfo NameTemplateDrivenDesign/Name Description基于参数驱动的快速建模插件/Description AuthorSwDevTeam/Author Version1.2.0/Version AssemblyPathSwAddinHost.dll/AssemblyPath LoadAtStartuptrue/LoadAtStartup SupportedVersions Version2018/Version Version2019/Version Version2020/Version Version2021/Version Version2022/Version Version2023/Version Version2024/Version /SupportedVersions /AddInInfo注意该XML文件必须与SwAddinHost.dll同目录且文件名固定为swAddin.xml。SolidWorks启动时会自动扫描所有已加载程序集所在目录下的此文件。相比注册表它支持版本白名单、启动延迟加载LoadAtStartupfalse、多语言描述通过Description langzh-CN且卸载时只需删DLLXML无残留。3. 核心模块拆解一个参数化拉伸特征创建请求的完整链路我们以最典型的“根据Excel参数表批量创建拉伸凸台”功能为例追踪从用户点击按钮到模型更新完成的全链路。这不是简单调用FeatureManager.FeatureExtrusion3()而是涉及线程调度、状态同步、错误恢复的完整闭环。3.1 UI层触发ParameterEditor.cs中的事件绑定// SwAddinUI/Forms/ParameterEditor.cs private void btnGenerate_Click(object sender, EventArgs e) { // 1. 从UI控件提取参数非阻塞 var config new ExtrudeConfig { ProfileSketchName txtSketchName.Text, Depth numDepth.Value, Direction cmbDirection.SelectedItem.ToString(), IsThinFeature chkThin.Checked }; // 2. 发起异步建模任务不阻塞UI线程 _modelService.GenerateExtrudeAsync(config) .ContinueWith(task { if (task.IsFaulted) { // 3. 异常统一处理弹窗日志 MessageBox.Show($建模失败{task.Exception?.InnerException?.Message}); _logger.LogError(task.Exception, GenerateExtrudeAsync failed); } else { MessageBox.Show(拉伸特征创建成功); } }, TaskScheduler.FromCurrentSynchronizationContext()); }逻辑说明这里的关键是ContinueWith(..., TaskScheduler.FromCurrentSynchronizationContext())。它确保回调一定在UI线程执行避免跨线程调用WinForm控件报InvalidOperationException。参数config是纯POCO对象不携带任何COM引用保证序列化安全。3.2 服务层调度SwAddinCore/Model/ExtrudeService.cs// SwAddinCore/Model/ExtrudeService.cs public class ExtrudeService : IExtrudeService { private readonly ISwModelContext _modelContext; // 由DI容器注入实际为SwAddinHost.SwModelContext private readonly ILoggerExtrudeService _logger; public ExtrudeService(ISwModelContext modelContext, ILoggerExtrudeService logger) { _modelContext modelContext; _logger logger; } public async Task GenerateExtrudeAsync(ExtrudeConfig config) { // 1. 验证输入业务规则检查非COM调用 if (string.IsNullOrWhiteSpace(config.ProfileSketchName)) throw new ArgumentException(草图名称不能为空); // 2. 切换到COM线程上下文关键 return await Task.Run(() { try { // 3. 获取当前活动文档线程安全 var model _modelContext.GetActiveModelDoc2(); if (model null) throw new InvalidOperationException(未打开任何SolidWorks文档); // 4. 执行COM操作此处为真实建模 var featureMgr model.FeatureManager; var sketch model.CreateDrawnSketch(config.ProfileSketchName); // 5. 调用SDK方法注意所有参数必须为COM原生类型 var feature featureMgr.FeatureExtrusion3( true, // isBlind false, // isDraft false, // isFlip 0, // draftAngle 0, // thickness config.Depth, // depth 0, // direction 0, // offset 0, // draftType 0, // draftDir 0, // draftAngle2 0, // draftDir2 0); // draftType2 _logger.LogInformation(成功创建拉伸特征{FeatureName}, feature.Name); return feature; } catch (COMException ex) when (ex.ErrorCode unchecked((int)0x800401E3)) { // 0x800401E3 RPC_E_WRONGTHREAD说明线程上下文错误 throw new InvalidOperationException(COM对象调用线程不匹配请检查SwModelContext实现, ex); } }); } }参数说明config.Depth必须为double类型SolidWorks SDK不接受decimal或floatfeatureMgr.FeatureExtrusion3()的第7个参数depth单位是米不是毫米这是血泪经验——传入100得到的是100米厚的板不是100mmsketch变量未在代码中使用是因为FeatureExtrusion3内部会自动关联当前草图显式创建只是为确保草图存在。3.3 宿主层保障SwAddinHost/SwModelContext.cs的线程安全实现// SwAddinHost/SwModelContext.cs public class SwModelContext : ISwModelContext { private readonly SldWorks _swApp; private readonly object _lock new object(); private IModelDoc2 _activeModel; public SwModelContext(SldWorks swApp) { _swApp swApp; // 1. 监听SolidWorks文档切换事件STA线程内 _swApp.ActiveDocChangeNotify OnActiveDocChanged; } private void OnActiveDocChanged() { // 2. 在STA线程中更新缓存避免多线程竞争 lock (_lock) { _activeModel _swApp.IActiveDoc2; } } public IModelDoc2 GetActiveModelDoc2() { lock (_lock) { // 3. 返回副本防止外部修改缓存对象 return _activeModel?.GetModelDoc2() ?? null; } } }逻辑说明GetActiveModelDoc2()返回的是IModelDoc2的新实例通过GetModelDoc2()方法而非缓存的原始引用。这是因为COM对象在跨线程传递时可能失效直接返回缓存引用会导致RPC_E_DISCONNECTED异常。每次调用都重新获取是牺牲一点性能换取100%稳定性。4. 常见问题排查这5个坑我替你踩过了SolidWorks二次开发最折磨人的不是写代码而是那些“明明语法没错却死活不工作”的玄学问题。以下是我在三个不同客户现场实测总结的高频故障点每一条都附带可复现的最小场景和根治方案。4.1 现象插件菜单显示正常点击后毫无反应调试器也进不去断点原因SwAddIn.ConnectToSW()方法中未正确设置ISwAddin接口的Connect属性或SldWorks对象未在STA线程初始化。SolidWorks在调用插件前会先检查Connect是否为true若为false则静默跳过。解决在SwAddIn.cs的ConnectToSW方法末尾强制设置Connect true并在构造函数中用Thread.CurrentThread.SetApartmentState(ApartmentState.STA)确保线程模型正确public class SwAddIn : SwAddin { public SwAddIn() { // 必须在构造函数中设置否则ConnectToSW执行时线程已非STA Thread.CurrentThread.SetApartmentState(ApartmentState.STA); } public override bool ConnectToSW(object ThisSW, int cookie) { _swApp (SldWorks)ThisSW; _cookie cookie; Connect true; // 关键缺这一行菜单点击无效 return true; } }4.2 现象在SolidWorks 2023中运行正常升级到2024后FeatureManager为null原因SolidWorks 2024更改了IModelDoc2.FeatureManager属性的COM接口IID接口标识符旧版interop DLL如SolidWorks.Interop.sldworks.dllv34无法正确绑定。解决删除项目中所有SolidWorks.Interop.*引用通过NuGet安装最新版SolidWorks.Interop.sldworks当前为v35.0.0。不要手动下载DLLNuGet包内含针对各版本的type library嵌入。4.3 现象批量创建100个特征时到第37个突然报System.Runtime.InteropServices.COMException: 0x80010108原因0x80010108是CO_E_SERVER_EXEC_FAILURE本质是SolidWorks主进程因长时间占用COM线程而拒绝新请求。常见于在单一线程中连续调用FeatureExtrusion3()超过30次。解决在循环中插入await Task.Delay(10)10ms足够让SW释放线程或改用FeatureManager.FeatureExtrusion4()新版API支持批量提交// 替换原来的循环 foreach (var config in configs) { await _service.GenerateExtrudeAsync(config); await Task.Delay(10); // 关键缓冲 } // 改为批量模式需SolidWorks 2022 var features featureMgr.FeatureExtrusion4( configs.Select(c c.Depth).ToArray(), // double[] depths configs.Select(c c.Direction).ToArray(), // int[] directions ... // 其他参数数组 );4.4 现象ISwModelContext.GetActiveModelDoc2()返回null但SolidWorks里明明打开了零件原因IActiveDoc2接口在某些情况下如刚打开文档、或文档处于“重建中”状态会短暂返回null。这不是Bug是SolidWorks的正常状态机行为。解决增加重试机制最多等待2秒每次间隔100mspublic async TaskIModelDoc2 GetActiveModelDoc2Async(int maxWaitMs 2000) { var startTime DateTime.Now; while ((DateTime.Now - startTime).TotalMilliseconds maxWaitMs) { var model GetActiveModelDoc2(); // 原始方法 if (model ! null model.GetType() ! typeof(object)) // 排除COM占位符 return model; await Task.Delay(100); } throw new TimeoutException(等待活动文档超时请确认SolidWorks已打开有效文档); }4.5 现象插件安装后SolidWorks启动变慢任务管理器显示SLDWORKS.exe内存持续增长原因在SwAddIn.DisconnectFromSW()中未释放SldWorks事件监听器导致SldWorks对象无法被GC回收形成内存泄漏。解决显式注销所有事件在DisconnectFromSW中添加public override void DisconnectFromSW() { // 注销所有事件必须 _swApp.ActiveDocChangeNotify - OnActiveDocChanged; _swApp.FileOpenPostNotify - OnFileOpenPost; _swApp.NewModelNotify2 - OnNewModel; // 清空缓存 _modelContext?.ClearCache(); // 显式释放COM对象可选但推荐 Marshal.ReleaseComObject(_swApp); _swApp null; }5. 二次开发改造指南如何把模板变成你自己的“设计规则引擎”拿到这个模板不是为了跑通Demo而是要把它变成你团队的设计规范载体。我经历过三个典型改造场景某高校实验室用它把《机械设计课程设计》的减速器建模规则固化成插件某汽车零部件厂用它将GDT公差标注逻辑嵌入建模流程某模具厂用它实现“一模多腔”参数化布局。所有成功案例都遵循同一套改造路径——不是改代码而是改“规则定义”。5.1 第一步定义你的设计规则DSL领域特定语言不要直接在C#里写if (partType bearing) { ... }。模板预留了SwAddinCore/Data/RuleEngine/目录用于存放JSON规则文件。例如轴承座的建模规则// Rules/bearing_housing.json { name: 轴承座, version: 1.0, parameters: [ { id: bearing_diameter, label: 轴承外径, type: number, unit: mm, min: 10, max: 500, default: 60 }, { id: mounting_hole_dia, label: 安装孔直径, type: number, unit: mm, formula: bearing_diameter * 0.6 2 } ], features: [ { type: extrude, profile: base_sketch, depth: bearing_diameter * 1.2, direction: normal }, { type: hole, diameter: mounting_hole_dia, depth: bearing_diameter * 0.8 } ] }改造要点formula字段支持简单数学表达式 - * /和括号由模板内置的ExpressionEvaluator解析。这样设计规则变更无需重新编译改JSON即可生效。我一般会让工艺工程师直接维护这个JSON开发只负责解析引擎。5.2 第二步扩展模型操作原子能力模板自带CreateExtrudeBoss、CreateHole等基础方法但你的业务可能需要CreateGearProfile或ApplySurfaceFinish。在SwAddinCore/Model/下新建类必须继承IModelOperationTParam接口// SwAddinCore/Model/GearProfileOperation.cs public class GearProfileOperation : IModelOperationGearProfileParams { public async Task ExecuteAsync(IModelDoc2 model, GearProfileParams param) { // 1. 创建齿轮草图调用SolidWorks API var sketch model.CreateDrawnSketch(gear_profile); // 2. 生成渐开线点阵纯C#计算不依赖COM var points InvoluteCalculator.CalculatePoints( param.PitchDiameter, param.TeethCount, param.PressureAngle); // 3. 绘制样条曲线调用COM sketch.CreateSpline(points.Select(p new double[]{p.X, p.Y, 0}).ToArray()); // 4. 记录操作日志供追溯 LogOperation(CreateGearProfile, param); } } // SwAddinCore/Data/Parameters/GearProfileParams.cs public class GearProfileParams { public double PitchDiameter { get; set; } public int TeethCount { get; set; } public double PressureAngle { get; set; } 20.0; // 默认20度 }验证方法为新操作编写单元测试Mock掉IModelDoc2只验证InvoluteCalculator的数学逻辑// Tests/ModelTests.cs [Test] public void GearProfile_CalculatesCorrectPoints() { // Arrange var calculator new InvoluteCalculator(); // Act var points calculator.CalculatePoints(100, 20, 20); // Assert Assert.That(points.Count, Is.EqualTo(50)); // 50个点 Assert.That(points[0].X, Is.EqualTo(50).Within(0.01)); // 起点X坐标应为半径 }5.3 第三步对接企业现有系统PLM/MES模板的SwAddinCore/Integration/目录预置了REST API客户端。假设你要从PLM系统拉取BOM结构驱动装配体自动生成// SwAddinCore/Integration/PlmClient.cs public class PlmClient { private readonly HttpClient _httpClient; public PlmClient(HttpClient httpClient) { _httpClient httpClient; _httpClient.DefaultRequestHeaders.Authorization new AuthenticationHeaderValue(Bearer, Environment.GetEnvironmentVariable(PLM_TOKEN)); } public async TaskBomStructure GetBomAsync(string partNumber) { var response await _httpClient.GetAsync($/api/v1/bom/{partNumber}); response.EnsureSuccessStatusCode(); return await response.Content.ReadFromJsonAsyncBomStructure(); } } // SwAddinCore/Model/AssemblyBuilder.cs public class AssemblyBuilder { private readonly PlmClient _plmClient; public AssemblyBuilder(PlmClient plmClient) _plmClient plmClient; public async Task BuildFromPlmAsync(string rootPartNumber) { var bom await _plmClient.GetBomAsync(rootPartNumber); foreach (var item in bom.Items) { // 1. 从PLM获取零件路径如\\server\parts\housing.sldprt var partPath item.FilePath; // 2. 在SolidWorks中插入零部件调用COM var assembly _modelContext.GetActiveModelDoc2() as IAssemblyDoc; assembly.AddComponent(partPath, 0, 0, 0); } } }改造技巧PlmClient通过依赖注入传入AssemblyBuilder不关心HTTP细节。这样当PLM系统从REST换成SOAP时只需替换PlmClient实现上层逻辑完全不动。从那以后我每次接入新系统都强制走一遍“定义接口 → Mock测试 → 实现对接”的三步再没出现过因第三方系统变更导致插件崩溃的情况。希望帮到你。本文还有配套的精品资源点击获取
