图解说明NX二次开发流程：从零开始也能做出自己的插件
你有没有遇到过这样的场景？
每天重复打开十几个NX模型，手动修改参数、导出图纸、更新BOM表……一上午就没了。
或者团队里总有人忘记标注关键尺寸、漏加中心线，导致下游返工不断？
如果你点头了，那这篇文章就是为你准备的。
我们不讲空话，也不堆术语，只用最直白的方式带你走通NX二次开发的完整路径——哪怕你只会一点C#基础，甚至没写过DLL，看完这篇也能独立做出第一个自动化小工具。
为什么企业都在做NX二次开发？
先说个真实案例：某汽车零部件公司的一个工程师写了段插件代码，实现了“一键生成支架类零件”。以前设计一个要40分钟，现在点一下按钮，3秒完成。全组15个人，每人每天省下2小时，一年下来相当于多出近300个工作日。
这不是神话，而是NX Open API的日常应用。
西门子NX本身功能强大，但它是通用软件。每个行业、每家企业都有自己的一套标准和流程。比如：
- 模具厂有固定的模架命名规则；
- 航空结构件必须带特定属性标签；
- 出图模板每年都要微调……
这些“个性化需求”，靠鼠标点是做不完的。于是，聪明人开始用程序来指挥NX干活。
这就是二次开发的本质：让电脑替你上班。
核心武器：NX Open API 到底是什么？
你可以把它想象成 NX 的“遥控器说明书”。
NX 内部所有操作——创建长方体、拉伸曲面、标注尺寸、保存文件——背后都有一行对应的 API 命令。而NX Open API就是官方公开的这本“命令大全”。
它能干什么？
| 操作类型 | 是否支持 |
|---|---|
| 创建几何体（块、圆柱、孔） | ✅ |
| 修改特征参数 | ✅ |
| 批量重命名 | ✅ |
| 导出PDF/DXF图纸 | ✅ |
| 读取材料属性 | ✅ |
| 和Excel交互 | ✅ |
| 连接Teamcenter | ✅ |
几乎你能想到的所有操作，它都能做到。
支持哪些语言？
| 语言 | 适合人群 | 开发效率 | 执行速度 |
|---|---|---|---|
| C++ | 资深开发者 | 中 | ⚡⚡⚡⚡⚡ |
| C# (.NET) | 大多数工程师 | ⚡⚡⚡⚡ | ⚡⚡⚡ |
| Python (Journal) | 新手入门 | ⚡⚡⚡⚡⚡ | ⚡⚡ |
建议新手从C# + Visual Studio入手。语法简单、调试方便、社区资源多，最关键的是——和 NX 集成得非常好。
第一步：把你的电脑变成“开发工作站”
别担心，不需要买新电脑。只要装对东西，普通办公机就能跑起来。
必备三件套
NX 软件本体（推荐 NX12 / NX2007）
- 安装时务必勾选Development Tools
- 否则会缺少头文件和库文件！Visual Studio（2019 或 2022 社区版免费）
- 不要用太老的版本，否则.NET框架不兼容SDK路径设置
- 系统环境变量中添加：UGII_BASE_DIR = C:\Program Files\Siemens\NX2007 PATH += %UGII_BASE_DIR%\NXBIN
🛠️ 小贴士：
NXBIN目录里有ugraf.exe，这是启动调试的关键。没有它，VS无法加载NX进程。
第二步：写出你的第一个插件 —— Hello World！
我们现在就动手做一个最简单的插件：当NX启动时，弹出一个消息框说“你好，世界！”。
在 Visual Studio 中操作：
- 新建项目 → Class Library (.NET Framework)
- 目标框架选
.NET Framework 4.0 添加引用：
-NXOpen.dll
-NXOpen.UF.dll
-NXOpen.UI.dll
（都在<NX安装目录>\Managed下）设置调试：
- 项目属性 → 调试
- 启动外部程序：C:\Program Files\Siemens\NX2007\NXBIN\ugraf.exe替换默认代码为下面这个模板：
using NXOpen; using NXOpen.UI; public class Program { public static Session theSession; public static Program theProgram; public void Main() { theSession = Session.GetSession(); theSession.ListingWindow.Open(); theSession.ListingWindow.WriteLine("✅ 插件已加载！"); // 弹窗提示 UI.GetUI().NXMessageBox.Show( "Hello NX", NXMessageBox.DialogType.Information, "你好，世界！" ); } public static void Start() { if (theProgram == null) theProgram = new Program(); theProgram.Main(); } public static int GetUnloadOption(string arg) { return Session.LibraryUnloadOption.Immediately; } }- 编译生成DLL
把DLL复制到：
<NX安装目录>\STARTUP启动NX → 看到弹窗了吗？恭喜！你已经跨过了最难的第一步！
💡 提示：如果没反应，请检查DLL名字是否与其他插件冲突；也可以在日志窗口查看报错信息。
秘密武器：用 Journal 自动生成代码
很多人卡在“不知道某个功能该怎么写代码”。其实有个“作弊器”——宏录制（Journal）。
它的原理很简单：你在界面上点什么，NX就自动记录成一行Python代码。
实战演示：如何快速学会“创建基准平面”的API？
- 打开NX → 工具 → Journal → 记录
- 手动创建一个基准面（比如通过三点）
- 停止录制 → 查看生成的
.py文件
你会看到类似这样的代码片段：
workPart = theSession.Parts.Work datumPlaneBuilder1 = workPart.Features.CreateDatumPlaneBuilder(None) plane1 = workPart.Planes.CreatePlane( point=Point3d(0, 0, 0), direction=Direction3d(0, 0, 1), orientation=SmartObject.AlignmentType.AlongX, flip=False, offset=0.0 ) datumPlaneBuilder1.Plane = plane1 datumFeature1 = datumPlaneBuilder1.Commit()虽然这是Python写的，但对象结构和C#几乎一模一样。你只需要稍作转换：
// 对应C#写法 Part workPart = theSession.Parts.Work; DatumPlaneBuilder builder = workPart.Features.CreateDatumPlaneBuilder(null); Plane plane = workPart.Planes.CreatePlane( new Point3d(0, 0, 0), new Direction3d(0, 0, 1), SmartObject.AlignmentType.AlongX, false, 0.0 ); builder.Plane = plane; Feature feature = builder.Commit();就这么轻松拿到了“创建基准面”的完整代码模板！
✅ 推荐做法：遇到不会的功能，先手动操作一遍，再看Journal生成的代码。久而久之，你就掌握了80%常用API。
实际应用场景：我能用它解决什么问题？
别以为这只是“技术玩具”，它真的能改变工作方式。
场景一：批量重命名孔特征
痛点：上百个孔叫 Hole(1)~Hole(234)，根本分不清用途。
解决方案：
foreach (Feature feat in workPart.Features) { if (feat.FeatureType == "Hole") { // 按规则重命名：HOLE_AIR_001, HOLE_WATER_002... feat.SetName($"HOLE_{prefix}_{index:D3}"); index++; } }运行后，一键搞定。
场景二：自动导出BOM到Excel
痛点：每次都要手动统计零件名、数量、材料，复制粘贴容易出错。
插件逻辑：
1. 遍历装配结构
2. 提取组件名称、实例数、材质属性
3. 调用 Excel COM 接口写入表格
4. 自动生成带时间戳的文件并打开
效果：点一下按钮，5秒出表。
场景三：防呆检查工具（保存前拦截）
痛点：新人总忘记加中心线或注释，图纸被打回。
插件策略：
- 注册事件监听：“部件即将保存”
- 检查是否存在未标注的关键特征
- 如果有问题，弹窗提醒并阻止保存
相当于给NX加了个“质量守门员”。
高手才知道的5个技巧
关闭屏幕刷新提升性能
csharp theSession.Preferences.Modeling.RefreshStatus = false; // ...大量建模操作... theSession.Preferences.Modeling.RefreshStatus = true;
可提速数倍！统一输出日志便于排查
csharp theSession.ListingWindow.WriteLine("正在处理第" + i + "个零件");
比Debug.Print更稳定。异常处理不能少
csharp try { ... } catch (NXException ex) { theSession.ListingWindow.WriteLine("错误：" + ex.Message); }
防止插件崩溃拖垮整个NX。尽量不用私有API
私有接口可能在新版NX中失效，影响兼容性。DLL签名保证安全
发布前用数字证书签名，防止被恶意篡改。
学习路线图：四步上手法
我建议所有初学者按这个节奏来：
第一步：先看
观察标准操作流程，搞清楚“我要自动化什么”。
第二步：再录
打开 Journal，手动操作一遍，拿到原始API调用序列。
第三步：后改
把生成的Python代码转成C#，加入条件判断、循环等逻辑。
第四步：终创
脱离Journal，独立编写完整功能模块，封装成可复用的工具。
坚持一个月，你会发现自己已经可以帮同事写小插件了。
写在最后
NX二次开发不是程序员的专属技能。
它更像是现代工程师的增强外挂。
就像CAD取代了图板，CAE取代了手算一样，自动化脚本正在成为新一代工程师的标配能力。
你现在花几个小时学会的东西，未来每天能帮你节省半小时。一年就是120小时，相当于多出了两周工作时间。
更重要的是，一旦你开始思考“这件事能不能让电脑来做”，你就已经进入了工程思维的新层次。
所以，别再犹豫了。
打开Visual Studio，新建一个项目，写下那句经典的：
theSession.ListingWindow.WriteLine("Hello, NX World!");然后按下F5——属于你的智能设计时代，正式开启。
如果你在配置过程中遇到任何问题，欢迎留言交流。我们一起把复杂的变简单，把不可能变成“下次试试这个方法”。
