Python项目封装为C#可调用动态库

由于 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 调用

1. 安装 Python.NET NuGet 包
   在 C# 项目中执行以下命令：

   dotnet add package Python.Runtime

   或者在 Visual Studio 的 NuGet 包管理器中搜索并安装 Python.Runtime 包。

2. 准备 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)

3. 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，并注意异常与资源释放，就能构建出高性能、易维护的混合应用。