C#如何与Python进行交互？Python.NET库实现C#调用Python脚本

小老鼠 2025-11-23 00:00:00 次阅读

使用Python.NET可在C#中直接调用Python脚本。1. 通过NuGet安装Python.Runtime包；2. 确保系统安装兼容Python版本并配置环境变量；3. 初始化Python运行时（PythonEngine.Initialize()）；4. 在Py.GIL()上下文中执行Python代码或导入模块；5. 支持基本类型自动转换，复杂数据通过list、dict传递；6. 使用try-catch捕获Python异常；7. 程序结束前调用PythonEngine.Shutdown()释放资源。该方案无需外部进程，适合集成机器学习与数据处理脚本。

在C#项目中调用Python脚本，Python.NET 是一个高效且直接的解决方案。它允许你在.NET环境中加载并执行Python代码，实现两者之间的无缝交互。不需要启动外部进程，所有操作都在同一进程中完成。

安装Python.NET

通过NuGet包管理器安装 Python.NET：

在Visual Studio中右键项目 → 管理NuGet程序包 → 搜索 Python.NET 并安装
或使用Package Manager命令：
Install-Package Python.Runtime
确保你的系统已安装兼容版本的Python（如3.7–3.11），并且环境变量配置正确

初始化Python运行时并执行脚本

在调用任何Python代码前，必须初始化Python运行时。以下是一个基本示例：

using Python.Runtime;

// 初始化Python引擎
PythonEngine.Initialize();
using (Py.GIL()) // 获取全局解释器锁
{
    dynamic sys = Py.Import("sys");
    sys.path.append(@"C:\YourPythonScripts"); // 添加自定义路径

    // 直接执行Python代码
    PythonEngine.Exec("print('Hello from Python!')");

    // 导入并调用Python脚本
    dynamic module = Py.Import("my_script");
    dynamic result = module.my_function(10, 20);
    Console.WriteLine(result);
}

注意：每次访问Python对象都需在 GIL（全局解释器锁） 上下文中进行，避免多线程冲突。

传递数据与处理返回值

Python.NET支持C#与Python之间的基本类型自动转换，例如int、string、double等。复杂类型可通过字典或列表传递：

C#中的 Dictionary 可以传给Python作为dict
数组或List可转换为Python list
从Python返回的对象可直接当作dynamic使用，动态调用其属性和方法

示例：

using (Py.GIL())
{
    dynamic np = Py.Import("numpy");
    dynamic arr = np.array(new int[] { 1, 2, 3, 4 });
    Console.WriteLine(arr.mean()); // 调用NumPy计算均值
}

异常处理与资源释放

执行Python代码可能抛出异常，应使用try-catch捕获Python异常：

try
{
    using (Py.GIL())
    {
        PythonEngine.Exec("raise ValueError('测试错误')");
    }
}
catch (PythonException e)
{
    Console.WriteLine($"Python错误: {e.Message}");
}

程序退出前建议调用 PythonEngine.Shutdown() 释放资源，防止内存泄漏。

基本上就这些。Python.NET让C#调用Python变得像本地调用一样自然，特别适合集成机器学习模型、数据分析脚本或复用现有Python工具。只要注意运行时初始化和GIL管理，就能稳定运行。不复杂但容易忽略细节。