SolidWorks二次开发模板：基于.NET 6的工程化插件架构

简介：本资源是面向机械设计工程师与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流水线编译、被不同版本SolidWorks（2018–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 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 version="1.0" encoding="utf-8"?> <AddInInfo> <Name>TemplateDrivenDesign</Name> <Description>基于参数驱动的快速建模插件</Description> <Author>SwDevTeam</Author> <Version>1.2.0</Version> <AssemblyPath>SwAddinHost.dll</AssemblyPath> <LoadAtStartup>true</LoadAtStartup> <SupportedVersions> <Version>2018</Version> <Version>2019</Version> <Version>2020</Version> <Version>2021</Version> <Version>2022</Version> <Version>2023</Version> <Version>2024</Version> </SupportedVersions> </AddInInfo>

注意：该XML文件必须与SwAddinHost.dll同目录，且文件名固定为swAddin.xml。SolidWorks启动时会自动扫描所有已加载程序集所在目录下的此文件。相比注册表，它支持版本白名单、启动延迟加载（LoadAtStartup=false）、多语言描述（通过<Description lang="zh-CN">），且卸载时只需删DLL+XML，无残留。

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 ILogger<ExtrudeService> _logger; public ExtrudeService(ISwModelContext modelContext, ILogger<ExtrudeService> 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或float；
• featureMgr.FeatureExtrusion3()的第7个参数（depth）单位是米，不是毫米！这是血泪经验——传入100得到的是100米厚的板，不是100mm；
• sketch变量未在代码中使用，是因为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）。不要手动下载DLL，NuGet包内含针对各版本的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秒，每次间隔100ms：

public async Task<IModelDoc2> 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，而是要把它变成你团队的设计规范载体。我经历过三个典型改造场景：某高校实验室用它把《机械设计课程设计》的减速器建模规则固化成插件；某汽车零部件厂用它将GD&T公差标注逻辑嵌入建模流程；某模具厂用它实现“一模多腔”参数化布局。所有成功案例，都遵循同一套改造路径——不是改代码，而是改“规则定义”。

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/下新建类，必须继承IModelOperation<TParam>接口：

// SwAddinCore/Model/GearProfileOperation.cs public class GearProfileOperation : IModelOperation<GearProfileParams> { 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 Task<BomStructure> GetBomAsync(string partNumber) { var response = await _httpClient.GetAsync($"/api/v1/bom/{partNumber}"); response.EnsureSuccessStatusCode(); return await response.Content.ReadFromJsonAsync<BomStructure>(); } } // 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测试 → 实现对接”的三步，再没出现过因第三方系统变更导致插件崩溃的情况。

希望帮到你。

本文还有配套的精品资源，点击获取