由于 Python 属于解释型语言,无法像 C++ 那样直接编译成 Windows 原生 .dll 供 C# 通过 P/Invoke 调用,但借助 Python.NET 可以实现近乎无缝的集成:在 C# 进程内部嵌入 Python 运行时,直接调用 Python 类、函数以及 OpenCV、Pandas 等第三方库,彻底规避进程间通信或 EXE 封装的繁琐方案。
先开门见山:Python 项目不能像 C++ 那样直接编译成 Windows 原生 .dll 文件供 C# 使用 P/Invoke 调用。但别担心,这并不意味着无路可走。通过 Python.NET 这一成熟的桥梁,你完全可以在 C# 进程内嵌入 Python 运行时,直接调用 Python 的类、函数,甚至像 OpenCV、Pandas 这样的第三方库——整个过程运行在同一个进程空间,既无需创建新进程,也无需将 Python 打包成 exe。
也就是说,“把 Python 项目转成 C# 能直接引用的 .dll”并非字面上的编译行为(Python 是解释型语言,没有原生的 .NET IL 输出能力),但利用 Python.NET,效果几乎等效:C# 程序可以加载并执行 Python 代码,访问 Python 对象——包括自定义类、NumPy 数组、OpenCV 的 cv2 模块、Pandas DataFrame 等。这完全绕开了 Process.Start() 的启动开销、标准流解析的易错性以及跨进程数据序列化的常见困扰。
✅ 推荐方案:使用 Python.NET 替代 EXE 调用
安装 Python.NET NuGet 包
在 C# 项目中执行以下命令:dotnet add package Python.Runtime
或者在 Visual Studio 的 NuGet 包管理器中搜索并安装
Python.Runtime包。准备 Python 模块(无需额外打包)
保留原始的 .py 文件即可,例如math_operation.py。关键是让 Python 运行时能够找到该模块,建议将其放在项目的 Resources 目录下,或通过代码显式指定路径:# math_operation.py class A: def add(self, a, b): return int(a + b) # 显式转为 int,避免类型不匹配 def subtract(self, a, b): return int(a - b)C# 中直接调用 Python 类
初始化 Python 运行时后,导入模块、实例化类、调用方法一气呵成:using Python.Runtime; class Program { static void Main(string[] args) { // 初始化 Python 运行时(自动发现或指定路径) // 注意:Python 版本需与 Python.NET 兼容,推荐 3.8–3.11 PythonEngine.Initialize(); // 设置 Python 模块搜索路径(可选) using (Py.GIL()) // 获取全局解释器锁 { // 导入 Python 模块 dynamic mathModule = Py.Import("math_operation"); // 实例化 Python 类 dynamic pyObj = mathModule.A(); // 直接调用方法(参数自动转换,返回值自动映射) int result1 = pyObj.add(3, 4); int result2 = pyObj.subtract(10, 6); Console.WriteLine($"The sum of 3 and 4 is: {result1}"); Console.WriteLine($"The difference between 10 and 6 is: {result2}"); } PythonEngine.Shutdown(); // 清理资源(进程退出时自动释放,可省略) } }
⚠️ 关键注意事项
- Python 环境依赖:Python.NET 要求系统已安装对应版本的 Python(例如
python39.dll),且 C# 应用的架构必须与 Python 一致(x64 / x86)。建议部署时将 Python 运行时(如嵌入式 Python)与应用一同分发。 - 第三方库支持:OpenCV、Pandas 等包含 C 扩展的库均可正常工作,前提是它们的 DLL 路径已加入
PATH,或通过PythonEngine.SetPythonHome()明确指定 Python 环境根目录。 - 线程安全:每次调用 Python API 前必须使用
using (Py.GIL())获取全局解释器锁;多线程场景下要特别留意 GIL 的管理。 - 异常处理:Python 抛出的异常会以
PythonException形式传递到 C# 端,务必使用try-catch捕获,并检查PyErr_Occurred()。 - 性能考量:相比纯 C#,首次调用时存在初始化开销,但后续调用速度接近原生——因为避免了进程创建、IPC 通信、JSON/XML 序列化等瓶颈。
✅ 总结
抛弃之前那种先将 Python 打包成 exe 再用 Process.Start() 调用的低效方案吧。Python.NET 才是将 Python 逻辑深度集成到 C# 应用中的工业级标准做法。它不仅解决了 null 返回、类型转换失败、环境隔离等问题,更让 C# 能够直接操作 Python 对象——无论是调用 cv2.imread() 加载图像,还是将 pandas.DataFrame 转换为 DataTable,都在统一的内存空间中完成。只要正确配置环境、合理管理 GIL,并注意异常与资源释放,就能构建出高性能、易维护的混合应用。
