关于Python中正确使用西门子NX NXOpen API及解决导入报错的求助

阿华AIGC实验室

2026-4-20

首先还原你的问题场景：

你编写了用于获取NX部件质量属性的Python代码：

import nxopen as nx
import os

def get_mass_properties(file_path):

    if not os.path.exists(file_path):
        raise ValueError(f"File not found: {file_path}")
    if not os.access(file_path, os.R_OK):
        raise PermissionError(f"Insufficient permissions to access file: {file_path}")

    with nx.Session() as session:
        workpart = session.parts.open(file_path)
        bodies = workpart.bodies
        if len(bodies) != 1:
            raise RuntimeError("Unsupported file format: multiple solids found")
        solid_body = bodies[0]
        mass = solid_body.GetMass()
        massprop = [mass]
        workpart.close()
        session.close()
        return massprop

massproperties = get_mass_properties("D:/NX Files/model1.prt")

尝试用pip安装NXOpen库后运行，出现了以下报错：

Traceback (most recent call last):
File "d:\Coding\NXOpen\basic 2.py", line 1, in <module>
import nxopen as nx
File "C:\Users\johan\AppData\Local\Programs\Python\Python311\Lib\site-packages\nxopen\__init__.py", line 1, in <module>
from . import cad
File "C:\Users\johan\AppData\Local\Programs\Python\Python311\Lib\site-packages\nxopen\cad\__init__.py", line 1, in <module>
from .code import *
File "C:\Users\johan\AppData\Local\Programs\Python\Python311\Lib\site-packages\nxopen\cad\code.py", line 3, in <module>
import NXOpen
ModuleNotFoundError: No module named 'NXOpen'

问题根源

你遇到的核心问题是：NXOpen不是一个可以通过pip独立安装的普通Python库。pip上的nxopen包是第三方封装的空壳，真正的NXOpen API是和西门子NX CAD软件深度绑定的，必须依赖NX的运行环境和自带的Python解释器才能使用。

解决步骤

1. 卸载冲突的第三方nxopen包

首先把pip安装的第三方包卸载，避免和官方NXOpen库冲突：

pip uninstall nxopen

2. 使用NX自带的Python环境

西门子NX CAD安装时会自带配套的Python解释器，这个环境已经内置了官方的NXOpen库，路径一般是：
C:\Program Files\Siemens\NX\[你的NX版本号]\Python
比如NX 2212的路径可能是C:\Program Files\Siemens\NX\2212\Python

3. 正确的运行方式

有两种常用的运行NXOpen Python脚本的方法：

方法一：在NX软件内部运行（最稳妥）
打开NX CAD软件，点击菜单栏的File -> Execute -> Python Script，选择你的.py脚本文件即可运行，这种方式不需要额外配置环境，直接依托NX的运行上下文。
方法二：用NX自带Python在外部运行
打开命令提示符，直接用NX自带的Python解释器路径来执行脚本，比如：
```
"C:\Program Files\Siemens\NX\2212\Python\python.exe" "d:\Coding\NXOpen\basic 2.py"
```

4. 代码的小修正（适配NXOpen官方规范）

你的原代码里有几个不符合NXOpen API规范的地方，比如用with nx.Session() as session（NX的Session是单例模式，不能用上下文管理器），这里给你修正后的代码：

import nxopen as nx
import os

def get_mass_properties(file_path):
    if not os.path.exists(file_path):
        raise ValueError(f"File not found: {file_path}")
    if not os.access(file_path, os.R_OK):
        raise PermissionError(f"Insufficient permissions to access file: {file_path}")

    # 获取NX的单例Session
    session = nx.Session.GetSession()
    workpart = None
    try:
        # 打开目标部件
        workpart = session.parts.open(file_path)
        # 获取部件中的所有实体
        bodies = workpart.bodies
        if len(bodies) != 1:
            raise RuntimeError("Unsupported file format: multiple solids found")
        solid_body = bodies[0]
        # 获取实体质量
        mass = solid_body.GetMass()
        return [mass]
    finally:
        # 确保部件被正确关闭
        if workpart is not None:
            session.parts.close(workpart, nx.BasePart.CloseWholeTree.TRUE, True)

# 调用函数并打印结果
massproperties = get_mass_properties("D:/NX Files/model1.prt")
print("Mass properties:", massproperties)