本文还有配套的精品资源点击获取简介这个资源包提供一套完整的VC6环境下开发的SolidWorks C插件源代码支持在SolidWorks 2001–2005等早期版本中运行。核心功能包括通过对话框输入尺寸参数自动驱动零件建模、装配体构建及关联工程图更新。代码结构清晰包含标准应用程序框架、SolidWorks COM接口调用封装sldworks_i.c、SldWorks.h/.cpp、文档/视图类TestAsmDoc/TestAsmView、资源文件图标、对话框、菜单以及完整项目配置.dsw/.dsp。所有关键逻辑配有中文注释可直接编译生成TestAsm.exe插件无需额外运行时依赖。配套RUN_INSTRUCTIONS.md说明加载与调试步骤ReadMe.txt补充开发背景与注意事项。适合想掌握SolidWorks Add-in加载机制、IDispatch接口调用、参数化CAD自动化流程的学习者或老版本系统维护人员参考使用。1. 这不是“老古董”而是一把打开SolidWorks底层逻辑的钥匙你点开这个资源包看到VC6、.dsw、.dsp、sldworks_i.c这些词第一反应可能是“这玩意儿还能跑连Windows XP都快进博物馆了。”但我要说恰恰相反——这套代码不是过时的残骸而是SolidWorks二次开发最原始、最干净、最不加修饰的“解剖标本”。它没有MFC的封装糖衣没有.NET的抽象层没有现代C的智能指针和Lambda所有操作都赤裸裸地落在COM接口调用、IDispatch参数传递、SafeArray内存管理、OLE消息循环这些最底层的肌肉和神经上。我当年在一家做非标自动化设备的老厂做技术支持客户用的还是SolidWorks 2003 SP5图纸服务器是Windows Server 2000整个产线PLC通信模块只认ActiveX控件——那时候能跑起来的插件就是能干活的插件没得选。关键词里写的“SolidWorks插件”“C二次开发”“参数化建模”这三个词放在一起就决定了它的价值锚点它解决的从来不是“能不能做”而是“为什么必须这么写”。比如为什么SldWorks.h里要把ISldWorks接口的每个方法都手动声明一遍而不是直接#import因为早期版本的#import生成的包装类会偷偷引入ATL或CRT依赖而客户现场严禁安装任何额外运行时为什么对话框资源DLG.rc里按钮ID要严格对应ON_COMMAND宏里的数字而不是用字符串因为MFC 6.0的消息映射表是纯静态数组索引ID错一位点击就静音为什么工程图更新必须先IGetModelView()再IRebuild()中间还夹着一个IGetSheet()调用因为2004年前的API里图纸视图和模型视图是两个完全独立的COM对象不显式获取图纸句柄IRebuild()根本找不到刷新目标。这套代码适配的是SolidWorks 2001–2005但它的设计思想至今没过时。你现在用C#写Add-inSwApp.NewDocument2()背后调的还是同一个COM方法你用Python调pywin32传的Dispatch对象底层依然是IDispatch*你调试现代插件卡在GetActiveDoc2()返回NULL排查路径跟当年查pSwApp-GetActiveDoc(pDoc)失败一模一样——都是COM线程模型STA、对象生命周期、上下文切换这三座大山。所以别急着嫌弃VC6它就像一把生锈但刃口依旧锋利的锉刀专用来打磨你对CAD自动化本质的理解。如果你的目标是快速出个功能插件那确实该用新框架但如果你的目标是看懂SolidWorks怎么把你的鼠标点击一步步变成特征树里那个拉伸凸台这套代码就是你绕不开的“源码级教科书”。2. 整体架构拆解一个标准MFC SDI应用如何“寄生”进SolidWorks2.1 为什么选MFC SDI而不是DLL或EXE独立进程很多人第一次接触SolidWorks Add-in会下意识认为“插件动态链接库”。但这个项目偏偏编译成TestAsm.exe——一个独立的可执行文件。这不是bug而是早期SolidWorks官方推荐的“外挂式”加载模式。原因很实在稳定性优先于性能。DLL模式要求插件与SolidWorks主进程共享同一内存空间和线程模型。一旦插件里有个野指针把ISwModelDoc对象delete两次整个SolidWorks瞬间蓝屏没错2003年真有这事。而EXE模式通过OLE Automation启动SolidWorks以CoCreateInstance方式在独立进程中创建插件对象天然隔离崩溃风险。MFC SDI单文档界面框架提供了完整的消息泵CWinApp::Run()、资源管理图标、菜单、对话框、文档/视图分离结构让开发者能像开发普通桌面软件一样组织代码不用从零手写WinMain和消息循环。TestAsmDoc.h/.cpp负责承载SolidWorks模型数据TestAsmView.h/.cpp负责渲染预览和交互反馈这种分工在2004年属于非常成熟的工程实践。提示TestAsm.dsw是VC6工作区文件里面包含TestAsm.dsp项目文件。打开后你会看到典型的MFC项目结构CWinApp派生类CTestAsmAppTestAsm.cpp主框架窗口CMainFrameMainFrm.cpp文档类CTestAsmDocTestAsmDoc.cpp视图类CTestAsmViewTestAsmView.cpp。这个骨架不是凭空来的它直接复用了MFC AppWizard生成的标准SDI模板只是把默认的CDocument替换成了对接SolidWorks API的定制类。2.2 SolidWorks COM接口封装sldworks_i.c与SldWorks.h的生死契约src/sldworks_i.c这个文件名看起来平平无奇但它才是整个项目的“心脏起搏器”。它不是头文件而是一个C语言源文件里面用#pragma pack(8)强制对齐手写了ISldWorks、IModelDoc2、IAssemblyDoc等核心接口的VTable布局。为什么不用#import sldworks.tlb答案藏在ReadMe.txt里一句不起眼的话“避免ATL依赖”。#import会自动生成.tlh/.tli文件里面大量使用CComPtr、CComQIPtr等ATL模板类而ATL需要atl.dll运行时支持——客户现场禁用一切第三方DLL。sldworks_i.c的实现逻辑极其朴素// sldworks_i.c 片段 typedef struct ISldWorksVtbl { BEGIN_INTERFACE HRESULT (STDMETHODCALLTYPE *QueryInterface)(ISldWorks *This, REFIID riid, void **ppvObject); ULONG (STDMETHODCALLTYPE *AddRef)(ISldWorks *This); ULONG (STDMETHODCALLTYPE *Release)(ISldWorks *This); // ... 后续100个方法按IDL定义顺序逐个声明 HRESULT (STDMETHODCALLTYPE *NewDocument)(ISldWorks *This, BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval); END_INTERFACE } ISldWorksVtbl;然后在SldWorks.h里定义接口指针// SldWorks.h interface ISldWorks : public IUnknown { BEGIN_INTERFACE STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE; STDMETHOD_(ULONG, AddRef)(THIS) PURE; STDMETHOD_(ULONG, Release)(THIS) PURE; // ... 对应sldworks_i.c中Vtbl的每个方法 STDMETHOD(NewDocument)(THIS_ BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval) PURE; END_INTERFACE };最后在SldWorks.cpp里完成真正的COM调用// SldWorks.cpp HRESULT CSldWorks::NewDocument(BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval) { return m_pISwApp-NewDocument(TemplateName, DocumentType, Width, Height, Retval); }这里m_pISwApp就是从CoCreateInstance拿到的原始ISldWorks*指针。整个过程没有任何魔法全是C风格的函数指针跳转。这种写法笨重但绝对可控——你知道每一行代码在内存里干了什么这对调试COM跨进程调用至关重要。2.3 参数驱动的核心闭环从对话框输入到工程图刷新的七步链整个插件的灵魂在于DLG.h/.cpp定义的参数对话框与后端建模逻辑的咬合。它不是简单的“填完点确定→建模”而是一个严密的状态机驱动流程。我们以“生成一个带法兰的轴类零件”为例拆解其内部七步链用户输入捕获对话框CTestAsmDlg通过DDX_Text将编辑框内容绑定到成员变量如m_dShaftDiameter,m_dFlangeWidth点击“确定”触发OnOK()参数校验与归一化OnOK()内调用ValidateInput()检查直径是否大于0、法兰宽度是否小于轴长并将毫米单位统一转换为SolidWorks内部单位米模型文档创建调用CSldWorks::NewDocument(_T(C:\\Program Files\\SolidWorks\\lang\\chinese\\Part.prtdot), swDocPART, ...)返回IModelDoc2*指针草图绘制获取当前草图平面IModelDoc2::CreateDrawnSketch用ISketchManager::CreateCircle画轴截面圆ISketchManager::CreateLine画法兰轮廓线特征生成调用IFeatureManager::FeatureExtrusion2拉伸轴体再调用IFeatureManager::FeatureCutExtrusion2切除法兰孔所有参数均来自对话框输入值装配体构建若选择“生成装配体”则用IAssemblyDoc::CreateNewComponent2插入已建好的零件再用IAssemblyDoc::AddMate3添加同心、贴合等配合关系工程图联动更新最关键的一步——先用IModelDoc2::GetSheetCount确认图纸数量再遍历每张图纸IModelDoc2::GetSheet对每张图纸调用IModelDoc2::ActivateView激活视图最后IModelDoc2::Rebuild强制刷新所有视图尺寸和注释。这个七步链里第6步和第7步最容易出问题。比如AddMate3的mateType参数2004年版本只支持swMateCOINCIDENT、swMateCONCENTRIC等有限枚举值传错值会导致配合失败但不报错又比如工程图刷新必须确保Rebuild前已ActivateView否则图纸视图缓存不会更新——这些细节全靠RUN_INSTRUCTIONS.md里一句“务必按顺序调用”和代码里密密麻麻的中文注释来兜底。3. 核心细节解析那些注释里藏着的“血泪教训”3.1 IDispatch接口调用SafeArray与VARIANT的魔鬼细节SolidWorks早期API大量使用IDispatch::Invoke进行后期绑定调用这是为了兼容VB6这类脚本语言。但C里手动构造DISPID、填充DISPPARAMS、管理SAFEARRAY堪称COM开发的“地狱模式”。TestAsmDoc.cpp里有一段经典代码用于批量设置草图尺寸// TestAsmDoc.cpp 片段设置多个草图尺寸 void CTestAsmDoc::SetSketchDimensions(double dDiameter, double dLength) { // 1. 构造参数数组[dDiameter, dLength] SAFEARRAYBOUND bounds[1] {2, 0}; // 2个元素下界0 SAFEARRAY* psa SafeArrayCreate(VT_R8, 1, bounds); // 创建双精度浮点数组 // 2. 锁定数组内存直接写入 double* pArray nullptr; SafeArrayAccessData(psa, (void**)pArray); pArray[0] dDiameter; // 直径 pArray[1] dLength; // 长度 SafeArrayUnaccessData(psa); // 3. 构造VARIANT参数VT_ARRAY | VT_R8 VARIANT varParams; VariantInit(varParams); varParams.vt VT_ARRAY | VT_R8; varParams.parray psa; // 4. 调用IDispatch::Invoke DISPID dispid DISPID_UNKNOWN; m_pISketch-GetIDsOfNames(IID_NULL, LSetDimension, 1, LOCALE_USER_DEFAULT, dispid); DISPPARAMS params {varParams, nullptr, 1, 0}; m_pISketch-Invoke(dispid, IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, params, nullptr, nullptr, nullptr); }这段代码表面看很规整但实际踩过三个深坑-坑一SafeArray内存泄漏。SafeArrayCreate分配的内存必须由SafeArrayDestroy释放。原代码里忘了调SafeArrayDestroy(psa)导致每次调用内存增长24字节SAFEARRAY结构体大小连续建模100次后SolidWorks直接OOM崩溃。修复方案是在VariantClear(varParams)之后补上SafeArrayDestroy(psa)-坑二VARIANT类型误用。varParams.vt必须是VT_ARRAY | VT_R8写成VT_R8或VT_ARRAY都会导致Invoke返回DISP_E_TYPEMISMATCH。这个错误在VC6调试器里极难发现因为VARIANT是个联合体vt字段错位后其他字段值全乱-坑三DISPID缓存失效。GetIDsOfNames每次调用都要解析字符串效率极低。正确做法是把dispid缓存为类成员变量在OnInitDialog里一次性获取后续直接复用。注意swconst.h里定义了所有DISPID常量如DISPID_Sketch_SetDimension 101但实际开发中强烈建议用GetIDsOfNames动态获取因为不同SolidWorks版本的DISPID可能微调。swconst.h仅作参考不能当真理。3.2 文档/视图分离的陷阱为什么TestAsmView总是显示空白TestAsmView.h/.cpp继承自CView理论上应该能显示模型预览。但很多初学者编译后发现视图区域一片漆黑调试发现OnDraw()里pDC-TextOut能画文字但IModelDoc2::ViewZoomtofit2()毫无反应。根源在于视图窗口句柄与SolidWorks图形上下文的绑定时机。SolidWorks的视图渲染依赖于IModelView对象而IModelView必须关联到一个有效的Windows窗口句柄HWND。CTestAsmView的OnInitialUpdate()里有这样一段// TestAsmView.cpp void CTestAsmView::OnInitialUpdate() { CView::OnInitialUpdate(); // 获取当前活动文档 CTestAsmDoc* pDoc GetDocument(); if (pDoc pDoc-m_pModelDoc) { // 尝试绑定窗口句柄 pDoc-m_pModelDoc-SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e_swWindowHandle, (long)m_hWnd); } }这段代码看似合理但存在致命时序错误OnInitialUpdate()执行时CTestAsmDoc的m_pModelDoc可能还未初始化文档刚创建但模型对象尚未完全加载。正确做法是把绑定逻辑移到CTestAsmDoc::OnNewDocument()成功创建模型后并增加WaitForModelLoad()轮询// TestAsmDoc.cpp BOOL CTestAsmDoc::OnNewDocument() { if (!CDocument::OnNewDocument()) return FALSE; // 创建SolidWorks模型 HRESULT hr m_pSwApp-NewDocument(..., m_pModelDoc); if (FAILED(hr)) return FALSE; // 等待模型完全加载轮询IsLoaded int nTry 0; while (nTry 100) { VARIANT_BOOL bLoaded VARIANT_FALSE; m_pModelDoc-get_IsLoaded(bLoaded); if (bLoaded VARIANT_TRUE) break; Sleep(50); // 每50ms检查一次 nTry; } // 此时再绑定窗口句柄 m_pModelDoc-SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e_swWindowHandle, (long)m_hWnd); return TRUE; }这个Sleep(50)看似粗暴却是2004年最可靠的同步方案。现代开发可用事件回调但那个年代COM对象状态通知机制还不完善轮询是唯一选择。3.3 资源文件的隐性依赖图标、菜单与对话框的加载路径TestAsm.rc和TestAsm.rc2定义了所有UI资源主菜单、工具栏图标、参数对话框。但TestAsm.ico放在res/目录下TestAsmDoc.ico却放在项目根目录——这个路径差异不是疏忽而是VC6资源编译器的硬性规定。TestAsm.rc里IDI_MAINFRAME ICON res\\TestAsm.ico主程序图标必须从res/子目录加载因为MFC默认资源搜索路径是./res/TestAsm.rc2里IDI_TESTASMDoc ICON TestAsmDoc.ico文档类图标显示在SolidWorks任务栏缩略图里必须放在项目根目录否则SolidWorks加载插件时会因找不到图标而静默失败且不报任何错误。更隐蔽的是对话框字体。DLG.rc里定义IDD_TESTASM_DIALOG DIALOGEX 0, 0, 317, 194 STYLE DS_SETFONT | DS_MODALFRAME | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU FONT 8, MS Sans Serif, 400, 0, 0x1这里的FONT 8, MS Sans Serif是关键。2004年SolidWorks主界面用的就是MS Sans Serif如果改成Tahoma或Segoe UI对话框文字会显示为方块GDI字体回退失败。这个细节在RUN_INSTRUCTIONS.md里被简化为“请勿修改.rc文件字体”但没说明原因——因为当时LOGFONT结构体的lfCharSet字段必须设为ANSI_CHARSET0而现代字体默认用DEFAULT_CHARSET导致字符映射错乱。4. 实操过程详解从零编译到SolidWorks中稳定运行4.1 开发环境搭建VC6 SolidWorks 2003 SDK的黄金组合别试图用VS2019打开.dsw文件——VC6的项目格式与现代IDE完全不兼容。你需要一台装有Windows XP SP3的物理机或虚拟机VMware Workstation 12.x兼容性最好然后按严格顺序安装Visual C 6.0 with Service Pack 6官网早已下架但微软仍提供SP6离线包vc6sp6.exe。安装后务必运行VC98\Bin\VCVARS32.BAT配置环境变量SolidWorks 2003 SP5.1这是本项目实测最稳定的版本。安装时勾选“Developer Tools”组件它会把swconst.h、sldworks.tlb等头文件复制到C:\Program Files\SolidWorks\api\手动补全SDK路径VC6默认不识别SolidWorks头文件。进入Tools → Options → Directories在“Include files”路径里添加C:\Program Files\SolidWorks\api\ C:\Program Files\SolidWorks\api\redist\在“Library files”路径里添加C:\Program Files\SolidWorks\api\lib\提示sldworks_i.c里的#include swconst.h之所以能通过编译全靠这一步。如果路径不对VC6会报fatal error C1083: Cannot open include file: swconst.h死活找不到头文件。4.2 编译配置关键项三个必须勾选的“保命选项”打开TestAsm.dsw右键TestAsm项目 →Settings→C/C选项卡以下三项是成败关键Preprocessor → Preprocessor definitions必须添加WIN32;_WINDOWS;_USRDLL;TESTASM_EXPORTS;_AFXDLL。其中_USRDLL告诉编译器这是DLL风格的EXE虽然后缀是.exe但链接方式是DLL_AFXDLL启用MFC动态链接Code Generation → Use run-time library必须选Multithreaded DLL (/MD)。选Single-threaded (/ML)会导致CString在多线程环境下崩溃选Debug Multithreaded DLL (/MDd)则无法在客户现场运行缺少调试版CRTLink → Project Options → Additional options必须添加/DELAYLOAD:sldworks.exe。这是延迟加载SolidWorks主程序的关键开关。如果不加TestAsm.exe启动时会立即尝试加载sldworks.exe而此时SolidWorks可能根本没运行直接弹窗报错退出。编译时还会遇到经典警告C4786: identifier was truncated to 255 characters in the browser information这是VC6模板符号名过长导致的不影响运行可在Project Settings → C/C → Advanced里勾选Disable Language Extensions暂时屏蔽。4.3 插件加载与调试注册表、日志与断点的三位一体编译成功生成TestAsm.exe后不能双击运行——它必须作为OLE服务器被SolidWorks调用。加载流程分三步第一步注册插件为OLE服务器以管理员身份运行VC6自带的regsvr32.exeregsvr32 C:\path\to\TestAsm.exe这会在注册表HKEY_CLASSES_ROOT\CLSID\{xxx}\InprocServer32下写入TestAsm.exe路径并设置ThreadingModelApartment。注意{xxx}是TestAsm.cpp里CLSID_TestAsm的GUID必须与注册表一致否则SolidWorks找不到插件。第二步在SolidWorks中启用Add-in启动SolidWorks 2003 →Tools → Add-ins...→ 勾选TestAsm→ 点击OK。此时SolidWorks会调用CTestAsmApp::InitInstance()你应该能在VC6的Output窗口看到TestAsm Add-in loaded successfully日志TRACE宏输出。第三步调试断点设置VC6调试时需将TestAsm.exe设为外部程序-Project → Settings → Debug → Executable for debug session填入C:\Program Files\SolidWorks\SOLIDWORKS.exe-Project → Settings → Debug → Program arguments留空让SolidWorks以默认方式启动- 在CTestAsmDlg::OnOK()第一行设断点然后按F5启动。VC6会自动启动SolidWorks当你在SolidWorks菜单里点击插件命令时程序就会停在断点处。注意如果断点不命中大概率是注册表未正确写入。用OLE/COM Object Vieweroleview.exe检查CLSID\TestAsm是否存在或直接用regedit查看HKEY_CLASSES_ROOT\CLSID\{xxx}下的键值。4.4 参数化建模实操案例从输入到工程图的完整演示我们以“生成一个阶梯轴”为例走一遍全流程启动SolidWorks 2003确保TestAsmAdd-in已启用点击菜单Tools → TestAsm → Generate Shaft弹出参数对话框输入参数-Shaft Diameter (mm): 30.0-Step1 Length (mm): 50.0-Step2 Diameter (mm): 25.0-Step2 Length (mm): 30.0-Keyway Width (mm): 8.0-Keyway Depth (mm): 4.0点击“确定”后台发生以下动作- 创建新零件文档swDocPART- 绘制两个同心圆草图Φ30和Φ25- 拉伸生成阶梯轴主体FeatureExtrusion2- 切除键槽FeatureCutExtrusion2深度4mm- 创建新工程图swDocDRAWING插入主视图和俯视图- 自动标注所有尺寸ISketchManager::CreateLinearDimension最终效果SolidWorks界面左侧出现新零件右侧自动弹出工程图窗口所有尺寸与输入参数严格对应。这个过程耗时约3秒在P4 2.4GHz机器上比手动建模快5倍以上。关键是所有操作都可追溯——你在TestAsmDoc.cpp里找到GenerateShaft()函数每一行代码都对应一个SolidWorks UI操作这就是参数化建模的终极魅力把工程师的经验固化成可复用、可审计、可批量执行的代码逻辑。5. 常见问题与排查技巧实录那些让老司机也挠头的“幽灵Bug”5.1 典型问题速查表问题现象可能原因排查步骤解决方案插件菜单不显示注册表CLSID未写入或路径错误1. 运行oleview.exe检查CLSID\TestAsm2. 查看HKEY_CLASSES_ROOT\CLSID\{xxx}\InprocServer32值重新运行regsvr32确认路径含空格时用英文引号包裹点击菜单无响应CTestAsmApp::InitInstance()中AfxOleInit()失败1. 在InitInstance()开头加TRACE(AfxOleInit%d\n, AfxOleInit());2. 查看Output窗口返回值确保Windows系统已安装OLE组件XP默认自带或重装VC6 SP6建模后工程图空白IModelDoc2::CreateDrawnViewFromModelView3参数错误1. 检查swModelView句柄是否为NULL2. 确认图纸尺寸模板路径是否存在在CreateDrawnView前加if(!pDrawingDoc) return;并用IModelDoc2::GetTemplateName验证模板有效性尺寸标注错位ISketchManager::CreateLinearDimension坐标系不匹配1. 打印pSketch-GetSketchTransform()矩阵2. 检查x1,y1,x2,y2是否在草图坐标系内使用ISketch::MapPoint将世界坐标转换为草图坐标再调用标注插件加载后SolidWorks崩溃IDispatch::Invoke参数类型不匹配1. 用OleView检查IDispatch接口定义2. 对比DISPPARAMS中rgvarg[0].vt与API文档要求严格按swconst.h中VARENUM定义设置vt如尺寸必须用VT_R85.2 独家避坑技巧十年老司机的私藏经验技巧一用TRACE替代MessageBox做调试VC6调试时MessageBox会阻塞SolidWorks主线程导致整个CAD界面假死。正确做法是用TRACE宏输出到VC6的Output窗口// 替换掉所有 MessageBox(Debug info) TRACE(_T(Step 3: Created sketch handle0x%08X\n), (DWORD)pSketch); TRACE(_T(Param dDiameter%.3f mm\n), m_dDiameter);输出格式用%08X打印指针地址%.3f控制小数位数避免科学计数法干扰阅读。技巧二SafeArray内存泄漏的终极检测法在TestAsm.cpp的InitInstance()里加入全局计数器#ifdef _DEBUG long g_lSafeArrayCount 0; #define SAFEARRAY_CREATE() InterlockedIncrement(g_lSafeArrayCount) #define SAFEARRAY_DESTROY() InterlockedDecrement(g_lSafeArrayCount) #else #define SAFEARRAY_CREATE() #define SAFEARRAY_DESTROY() #endif然后在SafeArrayCreate/SafeArrayDestroy调用处分别加宏。程序退出时如果g_lSafeArrayCount ! 0说明有泄漏——这个技巧帮我在2005年定位到一个隐藏三年的泄漏点。技巧三SolidWorks版本兼容性的“降级测试法”不要只测SolidWorks 2005必须按顺序测试2005 → 2004 → 2003 → 2001。因为API是向下兼容但不向上兼容。例如IAssemblyDoc::AddMate3在2005年支持12种配合类型但在2001年只支持3种。我的做法是在TestAsmDoc.cpp里写一个GetSolidWorksVersion()函数根据ISldWorks::GetVersion()返回值动态切换API调用分支int nVer m_pSwApp-GetVersion(); // 返回200500表示2005 if (nVer 200400) { // 用AddMate3 } else { // 降级用AddMate旧版API }技巧四工程图模板路径的“绝对路径陷阱”RUN_INSTRUCTIONS.md里说“把drawing.drwdot放在C:\temp\”但实际部署时客户可能改路径。解决方案是用SolidWorks内置路径// 获取SolidWorks默认图纸模板路径 BSTR bstrTemplatePath nullptr; m_pSwApp-GetUserPreferenceStringValue(swUserPreferenceStringValue_e_swDefaultDrawTemplate, bstrTemplatePath); // bstrTemplatePath C:\Program Files\SolidWorks\lang\chinese\drawing.drwdot这样无论客户装在哪都能拿到正确路径。6. 我的实际操作体会为什么这套代码值得你花三天时间吃透我在2006年接手一个汽车焊装夹具项目客户要求所有夹具零件必须按BOM表参数自动生成误差小于0.01mm。当时团队用VB6写了套插件但每次SolidWorks升级就崩溃维护成本极高。后来我翻出这套VC6源码花了整整三天一行行啃完SldWorks.cpp和TestAsmDoc.cpp最大的收获不是学会了怎么写插件而是彻底理解了SolidWorks的“状态机哲学”。SolidWorks不是一堆静态API的集合而是一个精密的状态机每一个IModelDoc2对象都有明确的IsLoaded、IsModified、IsActive状态每一次Rebuild()都依赖于前一次EditRebuild3()的成功甚至一个草图的IsFullyDefined状态会直接影响后续拉伸特征的生成结果。这套VC6代码里所有if (pDoc pDoc-m_pModelDoc)的判空所有while (!bLoaded) Sleep(50)的轮询所有VariantClear(varParams)的清理本质上都是在小心翼翼地维护这个状态机的完整性。所以如果你现在正被某个现代Add-in的随机崩溃折磨不妨回头看看这套“老古董”。它不会给你炫酷的UI也不会自动处理异常但它强迫你直面COM的本质——内存、线程、引用计数、接口契约。当你能徒手写出SafeArrayCreate和IDispatch::Invoke的完整调用链时你会发现所谓“高级框架”不过是把这套底层逻辑用更优雅的方式封装了一遍而已。最后分享一个小技巧把TestAsm.exe的图标换成你公司的logo用Resource Hacker工具替换res/TestAsm.ico然后在TestAsm.cpp的InitInstance()里加一行AfxMessageBox(_T(Powered by YourCompany));。当客户第一次看到自己公司的图标出现在SolidWorks菜单里那种信任感是任何技术文档都给不了的。本文还有配套的精品资源点击获取简介这个资源包提供一套完整的VC6环境下开发的SolidWorks C插件源代码支持在SolidWorks 2001–2005等早期版本中运行。核心功能包括通过对话框输入尺寸参数自动驱动零件建模、装配体构建及关联工程图更新。代码结构清晰包含标准应用程序框架、SolidWorks COM接口调用封装sldworks_i.c、SldWorks.h/.cpp、文档/视图类TestAsmDoc/TestAsmView、资源文件图标、对话框、菜单以及完整项目配置.dsw/.dsp。所有关键逻辑配有中文注释可直接编译生成TestAsm.exe插件无需额外运行时依赖。配套RUN_INSTRUCTIONS.md说明加载与调试步骤ReadMe.txt补充开发背景与注意事项。适合想掌握SolidWorks Add-in加载机制、IDispatch接口调用、参数化CAD自动化流程的学习者或老版本系统维护人员参考使用。本文还有配套的精品资源点击获取
VC6开发的SolidWorks插件源码：输入参数自动生成零件、装配体和工程图
本文还有配套的精品资源点击获取简介这个资源包提供一套完整的VC6环境下开发的SolidWorks C插件源代码支持在SolidWorks 2001–2005等早期版本中运行。核心功能包括通过对话框输入尺寸参数自动驱动零件建模、装配体构建及关联工程图更新。代码结构清晰包含标准应用程序框架、SolidWorks COM接口调用封装sldworks_i.c、SldWorks.h/.cpp、文档/视图类TestAsmDoc/TestAsmView、资源文件图标、对话框、菜单以及完整项目配置.dsw/.dsp。所有关键逻辑配有中文注释可直接编译生成TestAsm.exe插件无需额外运行时依赖。配套RUN_INSTRUCTIONS.md说明加载与调试步骤ReadMe.txt补充开发背景与注意事项。适合想掌握SolidWorks Add-in加载机制、IDispatch接口调用、参数化CAD自动化流程的学习者或老版本系统维护人员参考使用。1. 这不是“老古董”而是一把打开SolidWorks底层逻辑的钥匙你点开这个资源包看到VC6、.dsw、.dsp、sldworks_i.c这些词第一反应可能是“这玩意儿还能跑连Windows XP都快进博物馆了。”但我要说恰恰相反——这套代码不是过时的残骸而是SolidWorks二次开发最原始、最干净、最不加修饰的“解剖标本”。它没有MFC的封装糖衣没有.NET的抽象层没有现代C的智能指针和Lambda所有操作都赤裸裸地落在COM接口调用、IDispatch参数传递、SafeArray内存管理、OLE消息循环这些最底层的肌肉和神经上。我当年在一家做非标自动化设备的老厂做技术支持客户用的还是SolidWorks 2003 SP5图纸服务器是Windows Server 2000整个产线PLC通信模块只认ActiveX控件——那时候能跑起来的插件就是能干活的插件没得选。关键词里写的“SolidWorks插件”“C二次开发”“参数化建模”这三个词放在一起就决定了它的价值锚点它解决的从来不是“能不能做”而是“为什么必须这么写”。比如为什么SldWorks.h里要把ISldWorks接口的每个方法都手动声明一遍而不是直接#import因为早期版本的#import生成的包装类会偷偷引入ATL或CRT依赖而客户现场严禁安装任何额外运行时为什么对话框资源DLG.rc里按钮ID要严格对应ON_COMMAND宏里的数字而不是用字符串因为MFC 6.0的消息映射表是纯静态数组索引ID错一位点击就静音为什么工程图更新必须先IGetModelView()再IRebuild()中间还夹着一个IGetSheet()调用因为2004年前的API里图纸视图和模型视图是两个完全独立的COM对象不显式获取图纸句柄IRebuild()根本找不到刷新目标。这套代码适配的是SolidWorks 2001–2005但它的设计思想至今没过时。你现在用C#写Add-inSwApp.NewDocument2()背后调的还是同一个COM方法你用Python调pywin32传的Dispatch对象底层依然是IDispatch*你调试现代插件卡在GetActiveDoc2()返回NULL排查路径跟当年查pSwApp-GetActiveDoc(pDoc)失败一模一样——都是COM线程模型STA、对象生命周期、上下文切换这三座大山。所以别急着嫌弃VC6它就像一把生锈但刃口依旧锋利的锉刀专用来打磨你对CAD自动化本质的理解。如果你的目标是快速出个功能插件那确实该用新框架但如果你的目标是看懂SolidWorks怎么把你的鼠标点击一步步变成特征树里那个拉伸凸台这套代码就是你绕不开的“源码级教科书”。2. 整体架构拆解一个标准MFC SDI应用如何“寄生”进SolidWorks2.1 为什么选MFC SDI而不是DLL或EXE独立进程很多人第一次接触SolidWorks Add-in会下意识认为“插件动态链接库”。但这个项目偏偏编译成TestAsm.exe——一个独立的可执行文件。这不是bug而是早期SolidWorks官方推荐的“外挂式”加载模式。原因很实在稳定性优先于性能。DLL模式要求插件与SolidWorks主进程共享同一内存空间和线程模型。一旦插件里有个野指针把ISwModelDoc对象delete两次整个SolidWorks瞬间蓝屏没错2003年真有这事。而EXE模式通过OLE Automation启动SolidWorks以CoCreateInstance方式在独立进程中创建插件对象天然隔离崩溃风险。MFC SDI单文档界面框架提供了完整的消息泵CWinApp::Run()、资源管理图标、菜单、对话框、文档/视图分离结构让开发者能像开发普通桌面软件一样组织代码不用从零手写WinMain和消息循环。TestAsmDoc.h/.cpp负责承载SolidWorks模型数据TestAsmView.h/.cpp负责渲染预览和交互反馈这种分工在2004年属于非常成熟的工程实践。提示TestAsm.dsw是VC6工作区文件里面包含TestAsm.dsp项目文件。打开后你会看到典型的MFC项目结构CWinApp派生类CTestAsmAppTestAsm.cpp主框架窗口CMainFrameMainFrm.cpp文档类CTestAsmDocTestAsmDoc.cpp视图类CTestAsmViewTestAsmView.cpp。这个骨架不是凭空来的它直接复用了MFC AppWizard生成的标准SDI模板只是把默认的CDocument替换成了对接SolidWorks API的定制类。2.2 SolidWorks COM接口封装sldworks_i.c与SldWorks.h的生死契约src/sldworks_i.c这个文件名看起来平平无奇但它才是整个项目的“心脏起搏器”。它不是头文件而是一个C语言源文件里面用#pragma pack(8)强制对齐手写了ISldWorks、IModelDoc2、IAssemblyDoc等核心接口的VTable布局。为什么不用#import sldworks.tlb答案藏在ReadMe.txt里一句不起眼的话“避免ATL依赖”。#import会自动生成.tlh/.tli文件里面大量使用CComPtr、CComQIPtr等ATL模板类而ATL需要atl.dll运行时支持——客户现场禁用一切第三方DLL。sldworks_i.c的实现逻辑极其朴素// sldworks_i.c 片段 typedef struct ISldWorksVtbl { BEGIN_INTERFACE HRESULT (STDMETHODCALLTYPE *QueryInterface)(ISldWorks *This, REFIID riid, void **ppvObject); ULONG (STDMETHODCALLTYPE *AddRef)(ISldWorks *This); ULONG (STDMETHODCALLTYPE *Release)(ISldWorks *This); // ... 后续100个方法按IDL定义顺序逐个声明 HRESULT (STDMETHODCALLTYPE *NewDocument)(ISldWorks *This, BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval); END_INTERFACE } ISldWorksVtbl;然后在SldWorks.h里定义接口指针// SldWorks.h interface ISldWorks : public IUnknown { BEGIN_INTERFACE STDMETHOD(QueryInterface)(THIS_ REFIID riid, void **ppvObject) PURE; STDMETHOD_(ULONG, AddRef)(THIS) PURE; STDMETHOD_(ULONG, Release)(THIS) PURE; // ... 对应sldworks_i.c中Vtbl的每个方法 STDMETHOD(NewDocument)(THIS_ BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval) PURE; END_INTERFACE };最后在SldWorks.cpp里完成真正的COM调用// SldWorks.cpp HRESULT CSldWorks::NewDocument(BSTR TemplateName, long DocumentType, double Width, double Height, long *Retval) { return m_pISwApp-NewDocument(TemplateName, DocumentType, Width, Height, Retval); }这里m_pISwApp就是从CoCreateInstance拿到的原始ISldWorks*指针。整个过程没有任何魔法全是C风格的函数指针跳转。这种写法笨重但绝对可控——你知道每一行代码在内存里干了什么这对调试COM跨进程调用至关重要。2.3 参数驱动的核心闭环从对话框输入到工程图刷新的七步链整个插件的灵魂在于DLG.h/.cpp定义的参数对话框与后端建模逻辑的咬合。它不是简单的“填完点确定→建模”而是一个严密的状态机驱动流程。我们以“生成一个带法兰的轴类零件”为例拆解其内部七步链用户输入捕获对话框CTestAsmDlg通过DDX_Text将编辑框内容绑定到成员变量如m_dShaftDiameter,m_dFlangeWidth点击“确定”触发OnOK()参数校验与归一化OnOK()内调用ValidateInput()检查直径是否大于0、法兰宽度是否小于轴长并将毫米单位统一转换为SolidWorks内部单位米模型文档创建调用CSldWorks::NewDocument(_T(C:\\Program Files\\SolidWorks\\lang\\chinese\\Part.prtdot), swDocPART, ...)返回IModelDoc2*指针草图绘制获取当前草图平面IModelDoc2::CreateDrawnSketch用ISketchManager::CreateCircle画轴截面圆ISketchManager::CreateLine画法兰轮廓线特征生成调用IFeatureManager::FeatureExtrusion2拉伸轴体再调用IFeatureManager::FeatureCutExtrusion2切除法兰孔所有参数均来自对话框输入值装配体构建若选择“生成装配体”则用IAssemblyDoc::CreateNewComponent2插入已建好的零件再用IAssemblyDoc::AddMate3添加同心、贴合等配合关系工程图联动更新最关键的一步——先用IModelDoc2::GetSheetCount确认图纸数量再遍历每张图纸IModelDoc2::GetSheet对每张图纸调用IModelDoc2::ActivateView激活视图最后IModelDoc2::Rebuild强制刷新所有视图尺寸和注释。这个七步链里第6步和第7步最容易出问题。比如AddMate3的mateType参数2004年版本只支持swMateCOINCIDENT、swMateCONCENTRIC等有限枚举值传错值会导致配合失败但不报错又比如工程图刷新必须确保Rebuild前已ActivateView否则图纸视图缓存不会更新——这些细节全靠RUN_INSTRUCTIONS.md里一句“务必按顺序调用”和代码里密密麻麻的中文注释来兜底。3. 核心细节解析那些注释里藏着的“血泪教训”3.1 IDispatch接口调用SafeArray与VARIANT的魔鬼细节SolidWorks早期API大量使用IDispatch::Invoke进行后期绑定调用这是为了兼容VB6这类脚本语言。但C里手动构造DISPID、填充DISPPARAMS、管理SAFEARRAY堪称COM开发的“地狱模式”。TestAsmDoc.cpp里有一段经典代码用于批量设置草图尺寸// TestAsmDoc.cpp 片段设置多个草图尺寸 void CTestAsmDoc::SetSketchDimensions(double dDiameter, double dLength) { // 1. 构造参数数组[dDiameter, dLength] SAFEARRAYBOUND bounds[1] {2, 0}; // 2个元素下界0 SAFEARRAY* psa SafeArrayCreate(VT_R8, 1, bounds); // 创建双精度浮点数组 // 2. 锁定数组内存直接写入 double* pArray nullptr; SafeArrayAccessData(psa, (void**)pArray); pArray[0] dDiameter; // 直径 pArray[1] dLength; // 长度 SafeArrayUnaccessData(psa); // 3. 构造VARIANT参数VT_ARRAY | VT_R8 VARIANT varParams; VariantInit(varParams); varParams.vt VT_ARRAY | VT_R8; varParams.parray psa; // 4. 调用IDispatch::Invoke DISPID dispid DISPID_UNKNOWN; m_pISketch-GetIDsOfNames(IID_NULL, LSetDimension, 1, LOCALE_USER_DEFAULT, dispid); DISPPARAMS params {varParams, nullptr, 1, 0}; m_pISketch-Invoke(dispid, IID_NULL, LOCALE_USER_DEFAULT, DISPATCH_METHOD, params, nullptr, nullptr, nullptr); }这段代码表面看很规整但实际踩过三个深坑-坑一SafeArray内存泄漏。SafeArrayCreate分配的内存必须由SafeArrayDestroy释放。原代码里忘了调SafeArrayDestroy(psa)导致每次调用内存增长24字节SAFEARRAY结构体大小连续建模100次后SolidWorks直接OOM崩溃。修复方案是在VariantClear(varParams)之后补上SafeArrayDestroy(psa)-坑二VARIANT类型误用。varParams.vt必须是VT_ARRAY | VT_R8写成VT_R8或VT_ARRAY都会导致Invoke返回DISP_E_TYPEMISMATCH。这个错误在VC6调试器里极难发现因为VARIANT是个联合体vt字段错位后其他字段值全乱-坑三DISPID缓存失效。GetIDsOfNames每次调用都要解析字符串效率极低。正确做法是把dispid缓存为类成员变量在OnInitDialog里一次性获取后续直接复用。注意swconst.h里定义了所有DISPID常量如DISPID_Sketch_SetDimension 101但实际开发中强烈建议用GetIDsOfNames动态获取因为不同SolidWorks版本的DISPID可能微调。swconst.h仅作参考不能当真理。3.2 文档/视图分离的陷阱为什么TestAsmView总是显示空白TestAsmView.h/.cpp继承自CView理论上应该能显示模型预览。但很多初学者编译后发现视图区域一片漆黑调试发现OnDraw()里pDC-TextOut能画文字但IModelDoc2::ViewZoomtofit2()毫无反应。根源在于视图窗口句柄与SolidWorks图形上下文的绑定时机。SolidWorks的视图渲染依赖于IModelView对象而IModelView必须关联到一个有效的Windows窗口句柄HWND。CTestAsmView的OnInitialUpdate()里有这样一段// TestAsmView.cpp void CTestAsmView::OnInitialUpdate() { CView::OnInitialUpdate(); // 获取当前活动文档 CTestAsmDoc* pDoc GetDocument(); if (pDoc pDoc-m_pModelDoc) { // 尝试绑定窗口句柄 pDoc-m_pModelDoc-SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e_swWindowHandle, (long)m_hWnd); } }这段代码看似合理但存在致命时序错误OnInitialUpdate()执行时CTestAsmDoc的m_pModelDoc可能还未初始化文档刚创建但模型对象尚未完全加载。正确做法是把绑定逻辑移到CTestAsmDoc::OnNewDocument()成功创建模型后并增加WaitForModelLoad()轮询// TestAsmDoc.cpp BOOL CTestAsmDoc::OnNewDocument() { if (!CDocument::OnNewDocument()) return FALSE; // 创建SolidWorks模型 HRESULT hr m_pSwApp-NewDocument(..., m_pModelDoc); if (FAILED(hr)) return FALSE; // 等待模型完全加载轮询IsLoaded int nTry 0; while (nTry 100) { VARIANT_BOOL bLoaded VARIANT_FALSE; m_pModelDoc-get_IsLoaded(bLoaded); if (bLoaded VARIANT_TRUE) break; Sleep(50); // 每50ms检查一次 nTry; } // 此时再绑定窗口句柄 m_pModelDoc-SetUserPreferenceIntegerValue(swUserPreferenceIntegerValue_e_swWindowHandle, (long)m_hWnd); return TRUE; }这个Sleep(50)看似粗暴却是2004年最可靠的同步方案。现代开发可用事件回调但那个年代COM对象状态通知机制还不完善轮询是唯一选择。3.3 资源文件的隐性依赖图标、菜单与对话框的加载路径TestAsm.rc和TestAsm.rc2定义了所有UI资源主菜单、工具栏图标、参数对话框。但TestAsm.ico放在res/目录下TestAsmDoc.ico却放在项目根目录——这个路径差异不是疏忽而是VC6资源编译器的硬性规定。TestAsm.rc里IDI_MAINFRAME ICON res\\TestAsm.ico主程序图标必须从res/子目录加载因为MFC默认资源搜索路径是./res/TestAsm.rc2里IDI_TESTASMDoc ICON TestAsmDoc.ico文档类图标显示在SolidWorks任务栏缩略图里必须放在项目根目录否则SolidWorks加载插件时会因找不到图标而静默失败且不报任何错误。更隐蔽的是对话框字体。DLG.rc里定义IDD_TESTASM_DIALOG DIALOGEX 0, 0, 317, 194 STYLE DS_SETFONT | DS_MODALFRAME | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU FONT 8, MS Sans Serif, 400, 0, 0x1这里的FONT 8, MS Sans Serif是关键。2004年SolidWorks主界面用的就是MS Sans Serif如果改成Tahoma或Segoe UI对话框文字会显示为方块GDI字体回退失败。这个细节在RUN_INSTRUCTIONS.md里被简化为“请勿修改.rc文件字体”但没说明原因——因为当时LOGFONT结构体的lfCharSet字段必须设为ANSI_CHARSET0而现代字体默认用DEFAULT_CHARSET导致字符映射错乱。4. 实操过程详解从零编译到SolidWorks中稳定运行4.1 开发环境搭建VC6 SolidWorks 2003 SDK的黄金组合别试图用VS2019打开.dsw文件——VC6的项目格式与现代IDE完全不兼容。你需要一台装有Windows XP SP3的物理机或虚拟机VMware Workstation 12.x兼容性最好然后按严格顺序安装Visual C 6.0 with Service Pack 6官网早已下架但微软仍提供SP6离线包vc6sp6.exe。安装后务必运行VC98\Bin\VCVARS32.BAT配置环境变量SolidWorks 2003 SP5.1这是本项目实测最稳定的版本。安装时勾选“Developer Tools”组件它会把swconst.h、sldworks.tlb等头文件复制到C:\Program Files\SolidWorks\api\手动补全SDK路径VC6默认不识别SolidWorks头文件。进入Tools → Options → Directories在“Include files”路径里添加C:\Program Files\SolidWorks\api\ C:\Program Files\SolidWorks\api\redist\在“Library files”路径里添加C:\Program Files\SolidWorks\api\lib\提示sldworks_i.c里的#include swconst.h之所以能通过编译全靠这一步。如果路径不对VC6会报fatal error C1083: Cannot open include file: swconst.h死活找不到头文件。4.2 编译配置关键项三个必须勾选的“保命选项”打开TestAsm.dsw右键TestAsm项目 →Settings→C/C选项卡以下三项是成败关键Preprocessor → Preprocessor definitions必须添加WIN32;_WINDOWS;_USRDLL;TESTASM_EXPORTS;_AFXDLL。其中_USRDLL告诉编译器这是DLL风格的EXE虽然后缀是.exe但链接方式是DLL_AFXDLL启用MFC动态链接Code Generation → Use run-time library必须选Multithreaded DLL (/MD)。选Single-threaded (/ML)会导致CString在多线程环境下崩溃选Debug Multithreaded DLL (/MDd)则无法在客户现场运行缺少调试版CRTLink → Project Options → Additional options必须添加/DELAYLOAD:sldworks.exe。这是延迟加载SolidWorks主程序的关键开关。如果不加TestAsm.exe启动时会立即尝试加载sldworks.exe而此时SolidWorks可能根本没运行直接弹窗报错退出。编译时还会遇到经典警告C4786: identifier was truncated to 255 characters in the browser information这是VC6模板符号名过长导致的不影响运行可在Project Settings → C/C → Advanced里勾选Disable Language Extensions暂时屏蔽。4.3 插件加载与调试注册表、日志与断点的三位一体编译成功生成TestAsm.exe后不能双击运行——它必须作为OLE服务器被SolidWorks调用。加载流程分三步第一步注册插件为OLE服务器以管理员身份运行VC6自带的regsvr32.exeregsvr32 C:\path\to\TestAsm.exe这会在注册表HKEY_CLASSES_ROOT\CLSID\{xxx}\InprocServer32下写入TestAsm.exe路径并设置ThreadingModelApartment。注意{xxx}是TestAsm.cpp里CLSID_TestAsm的GUID必须与注册表一致否则SolidWorks找不到插件。第二步在SolidWorks中启用Add-in启动SolidWorks 2003 →Tools → Add-ins...→ 勾选TestAsm→ 点击OK。此时SolidWorks会调用CTestAsmApp::InitInstance()你应该能在VC6的Output窗口看到TestAsm Add-in loaded successfully日志TRACE宏输出。第三步调试断点设置VC6调试时需将TestAsm.exe设为外部程序-Project → Settings → Debug → Executable for debug session填入C:\Program Files\SolidWorks\SOLIDWORKS.exe-Project → Settings → Debug → Program arguments留空让SolidWorks以默认方式启动- 在CTestAsmDlg::OnOK()第一行设断点然后按F5启动。VC6会自动启动SolidWorks当你在SolidWorks菜单里点击插件命令时程序就会停在断点处。注意如果断点不命中大概率是注册表未正确写入。用OLE/COM Object Vieweroleview.exe检查CLSID\TestAsm是否存在或直接用regedit查看HKEY_CLASSES_ROOT\CLSID\{xxx}下的键值。4.4 参数化建模实操案例从输入到工程图的完整演示我们以“生成一个阶梯轴”为例走一遍全流程启动SolidWorks 2003确保TestAsmAdd-in已启用点击菜单Tools → TestAsm → Generate Shaft弹出参数对话框输入参数-Shaft Diameter (mm): 30.0-Step1 Length (mm): 50.0-Step2 Diameter (mm): 25.0-Step2 Length (mm): 30.0-Keyway Width (mm): 8.0-Keyway Depth (mm): 4.0点击“确定”后台发生以下动作- 创建新零件文档swDocPART- 绘制两个同心圆草图Φ30和Φ25- 拉伸生成阶梯轴主体FeatureExtrusion2- 切除键槽FeatureCutExtrusion2深度4mm- 创建新工程图swDocDRAWING插入主视图和俯视图- 自动标注所有尺寸ISketchManager::CreateLinearDimension最终效果SolidWorks界面左侧出现新零件右侧自动弹出工程图窗口所有尺寸与输入参数严格对应。这个过程耗时约3秒在P4 2.4GHz机器上比手动建模快5倍以上。关键是所有操作都可追溯——你在TestAsmDoc.cpp里找到GenerateShaft()函数每一行代码都对应一个SolidWorks UI操作这就是参数化建模的终极魅力把工程师的经验固化成可复用、可审计、可批量执行的代码逻辑。5. 常见问题与排查技巧实录那些让老司机也挠头的“幽灵Bug”5.1 典型问题速查表问题现象可能原因排查步骤解决方案插件菜单不显示注册表CLSID未写入或路径错误1. 运行oleview.exe检查CLSID\TestAsm2. 查看HKEY_CLASSES_ROOT\CLSID\{xxx}\InprocServer32值重新运行regsvr32确认路径含空格时用英文引号包裹点击菜单无响应CTestAsmApp::InitInstance()中AfxOleInit()失败1. 在InitInstance()开头加TRACE(AfxOleInit%d\n, AfxOleInit());2. 查看Output窗口返回值确保Windows系统已安装OLE组件XP默认自带或重装VC6 SP6建模后工程图空白IModelDoc2::CreateDrawnViewFromModelView3参数错误1. 检查swModelView句柄是否为NULL2. 确认图纸尺寸模板路径是否存在在CreateDrawnView前加if(!pDrawingDoc) return;并用IModelDoc2::GetTemplateName验证模板有效性尺寸标注错位ISketchManager::CreateLinearDimension坐标系不匹配1. 打印pSketch-GetSketchTransform()矩阵2. 检查x1,y1,x2,y2是否在草图坐标系内使用ISketch::MapPoint将世界坐标转换为草图坐标再调用标注插件加载后SolidWorks崩溃IDispatch::Invoke参数类型不匹配1. 用OleView检查IDispatch接口定义2. 对比DISPPARAMS中rgvarg[0].vt与API文档要求严格按swconst.h中VARENUM定义设置vt如尺寸必须用VT_R85.2 独家避坑技巧十年老司机的私藏经验技巧一用TRACE替代MessageBox做调试VC6调试时MessageBox会阻塞SolidWorks主线程导致整个CAD界面假死。正确做法是用TRACE宏输出到VC6的Output窗口// 替换掉所有 MessageBox(Debug info) TRACE(_T(Step 3: Created sketch handle0x%08X\n), (DWORD)pSketch); TRACE(_T(Param dDiameter%.3f mm\n), m_dDiameter);输出格式用%08X打印指针地址%.3f控制小数位数避免科学计数法干扰阅读。技巧二SafeArray内存泄漏的终极检测法在TestAsm.cpp的InitInstance()里加入全局计数器#ifdef _DEBUG long g_lSafeArrayCount 0; #define SAFEARRAY_CREATE() InterlockedIncrement(g_lSafeArrayCount) #define SAFEARRAY_DESTROY() InterlockedDecrement(g_lSafeArrayCount) #else #define SAFEARRAY_CREATE() #define SAFEARRAY_DESTROY() #endif然后在SafeArrayCreate/SafeArrayDestroy调用处分别加宏。程序退出时如果g_lSafeArrayCount ! 0说明有泄漏——这个技巧帮我在2005年定位到一个隐藏三年的泄漏点。技巧三SolidWorks版本兼容性的“降级测试法”不要只测SolidWorks 2005必须按顺序测试2005 → 2004 → 2003 → 2001。因为API是向下兼容但不向上兼容。例如IAssemblyDoc::AddMate3在2005年支持12种配合类型但在2001年只支持3种。我的做法是在TestAsmDoc.cpp里写一个GetSolidWorksVersion()函数根据ISldWorks::GetVersion()返回值动态切换API调用分支int nVer m_pSwApp-GetVersion(); // 返回200500表示2005 if (nVer 200400) { // 用AddMate3 } else { // 降级用AddMate旧版API }技巧四工程图模板路径的“绝对路径陷阱”RUN_INSTRUCTIONS.md里说“把drawing.drwdot放在C:\temp\”但实际部署时客户可能改路径。解决方案是用SolidWorks内置路径// 获取SolidWorks默认图纸模板路径 BSTR bstrTemplatePath nullptr; m_pSwApp-GetUserPreferenceStringValue(swUserPreferenceStringValue_e_swDefaultDrawTemplate, bstrTemplatePath); // bstrTemplatePath C:\Program Files\SolidWorks\lang\chinese\drawing.drwdot这样无论客户装在哪都能拿到正确路径。6. 我的实际操作体会为什么这套代码值得你花三天时间吃透我在2006年接手一个汽车焊装夹具项目客户要求所有夹具零件必须按BOM表参数自动生成误差小于0.01mm。当时团队用VB6写了套插件但每次SolidWorks升级就崩溃维护成本极高。后来我翻出这套VC6源码花了整整三天一行行啃完SldWorks.cpp和TestAsmDoc.cpp最大的收获不是学会了怎么写插件而是彻底理解了SolidWorks的“状态机哲学”。SolidWorks不是一堆静态API的集合而是一个精密的状态机每一个IModelDoc2对象都有明确的IsLoaded、IsModified、IsActive状态每一次Rebuild()都依赖于前一次EditRebuild3()的成功甚至一个草图的IsFullyDefined状态会直接影响后续拉伸特征的生成结果。这套VC6代码里所有if (pDoc pDoc-m_pModelDoc)的判空所有while (!bLoaded) Sleep(50)的轮询所有VariantClear(varParams)的清理本质上都是在小心翼翼地维护这个状态机的完整性。所以如果你现在正被某个现代Add-in的随机崩溃折磨不妨回头看看这套“老古董”。它不会给你炫酷的UI也不会自动处理异常但它强迫你直面COM的本质——内存、线程、引用计数、接口契约。当你能徒手写出SafeArrayCreate和IDispatch::Invoke的完整调用链时你会发现所谓“高级框架”不过是把这套底层逻辑用更优雅的方式封装了一遍而已。最后分享一个小技巧把TestAsm.exe的图标换成你公司的logo用Resource Hacker工具替换res/TestAsm.ico然后在TestAsm.cpp的InitInstance()里加一行AfxMessageBox(_T(Powered by YourCompany));。当客户第一次看到自己公司的图标出现在SolidWorks菜单里那种信任感是任何技术文档都给不了的。本文还有配套的精品资源点击获取简介这个资源包提供一套完整的VC6环境下开发的SolidWorks C插件源代码支持在SolidWorks 2001–2005等早期版本中运行。核心功能包括通过对话框输入尺寸参数自动驱动零件建模、装配体构建及关联工程图更新。代码结构清晰包含标准应用程序框架、SolidWorks COM接口调用封装sldworks_i.c、SldWorks.h/.cpp、文档/视图类TestAsmDoc/TestAsmView、资源文件图标、对话框、菜单以及完整项目配置.dsw/.dsp。所有关键逻辑配有中文注释可直接编译生成TestAsm.exe插件无需额外运行时依赖。配套RUN_INSTRUCTIONS.md说明加载与调试步骤ReadMe.txt补充开发背景与注意事项。适合想掌握SolidWorks Add-in加载机制、IDispatch接口调用、参数化CAD自动化流程的学习者或老版本系统维护人员参考使用。本文还有配套的精品资源点击获取
