Python.NET 在加载含多个嵌套类或依赖类的 C# 程序集时，常因目标框架不兼容（如误用 .NET 8 而非 .NET Framework）导致“Module not found”错误；正确选择 .NET Framework 4.8 等受支持的运行时可彻底解决该问题。
python.net 在加载含多个嵌套类或依赖类的 c# 程统集时，常因目标框架不兼容（如误用 .net 8 而非 .net framework）导致“module not found”错误；正确选择 .net framework 4.8 等受支持的运行时可彻底解决该问题。
Python.NET 是 Python 与 .NET 生态互通的关键桥梁，但其对 .NET 运行时版本的支持存在明确边界。一个典型误区是：开发者在 Visual Studio 中新建了基于 .NET 8（或 .NET 5/6/7） 的类库项目（如 TestProject.csproj），并定义了包含多个引用类型字段的类：
// TestClass.cs
public class TestObject { public string Name { get; set; } }
public class TestClass
{
public TestObject test1;
public TestObject test2;
}随后在 Python 中尝试加载：
import clr
import sys
sys.path.append(r"C:\path\to\bin\Debug") # 注意：应为输出目录，非项目路径
clr.AddReference("TestProject") # 注意：参数是程序集名称（不含 .dll），非文件名
from TestProject import TestClass此时极易触发 ImportError: No module named 'TestProject' 或 System.IO.FileNotFoundException —— 表面看是模块未找到，实则根源在于 Python.NET 当前稳定版（如 3.0.x）对现代 .NET Core/.NET 5+ 运行时的原生支持有限。它主要设计用于与 .NET Framework 4.6.1–4.8 兼容，依赖 mscoree.dll 和传统 CLR 加载机制。
✅ 正确做法如下：
立即学习“Python免费学习笔记（深入）”；
重建 C# 项目为 .NET Framework 类库
在 Visual Studio 中新建项目 → 选择 “类库 (.NET Framework)” → 目标框架设为 .NET Framework 4.8（推荐，兼容性最佳）。确保生成输出为 TestProject.dll，且无 runtimeconfig.json 或 deps.json 等 .NET Core 特有文件。-
Python 端严格校验路径与引用名
- sys.path.append() 必须指向 .dll 所在输出目录（如 bin\Debug\），而非源码目录；
- clr.AddReference("TestProject") 中的名称必须与程序集 AssemblyName 一致（默认等于项目名，可通过 .csproj 中
核实）； - 避免使用 clr.AddReferenceToFileAndPath() 除非必要——它绕过 GAC 和探测逻辑，易引发类型解析失败。
-
验证跨语言实例化
成功加载后，可安全创建多实例并访问嵌套类型：# 实例化主类 instance = TestClass() # 初始化嵌套对象（注意：C# 字段默认为 null，需手动 new） instance.test1 = TestObject() instance.test1.Name = "First" instance.test2 = TestObject() instance.test2.Name = "Second" print(instance.test1.Name, instance.test2.Name) # 输出：First Second
⚠️ 注意事项：
- Python.NET 3.x 对 .NET 6/7/8 的实验性支持需启用 --runtime=net6.0 启动参数并配合 pythonnet 预编译版本，生产环境仍强烈推荐 .NET Framework 4.8；
- 若必须使用 .NET Core/.NET 5+，请改用 Python for .NET 的替代方案，如 dotnet-py 或通过 gRPC/REST API 解耦；
- 确保 Python 架构（x64/x86）与目标 .NET Framework 运行时完全匹配，混合架构会导致 BadImageFormatException。
总结：该问题本质是运行时环境错配，而非代码逻辑缺陷。坚持“C# 侧用 .NET Framework 4.8 + Python 侧规范引用路径”，即可稳定支持任意复杂度的类结构（含多实例、继承、泛型等），充分发挥 Python.NET 在工业自动化、金融计算等场景中的互操作价值。
