如何为控制台与WPF .NET应用设置PythonNET的Runtime.PythonDLL（PIP安装）

配置遗漏与错误点说明 #

• 错误1：直接覆盖PATH环境变量而非追加
  原有代码直接将PATH替换为Python根目录，会丢失系统原有依赖路径，需将Python根目录追加到现有PATH的最前面，保证优先加载对应版本的python310.dll
• 错误2：PYTHONPATH配置不完整
  PYTHONPATH需要包含Python标准库路径、第三方库（site-packages）路径，不能仅指向pythonnet目录，否则Python解释器无法加载内置模块
• 错误3：缺少显式指定Python核心DLL的配置
  触发BadPythonDllException的核心原因通常是PythonNET找不到对应版本的Python核心DLL，可通过Runtime.PythonDLL属性显式指定路径规避自动搜索的错误
• 遗漏项：项目平台匹配校验
  需确保C#项目的目标平台与Python安装的平台一致，如Python 3.10是64位版本，C#项目需将目标平台设置为x64，不能使用默认的Any CPU或32位配置
• 遗漏项：项目引用校验
  需提前在C#项目中添加对Python.Runtime.dll的引用，引用路径对应你安装生成的C:\Users\Justin\AppData\Local\Programs\Python\Python310\Lib\site-packages\pythonnet\runtime\Python.Runtime.dll即可

修正后的控制台配置代码 #

using System;
using System.Collections.Generic;
using Python.Runtime;

namespace ConsoleApp_PythonNET_Test
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 显式指定Python核心DLL路径，优先解决BadPythonDllException
            Runtime.PythonDLL = @"C:\Users\Justin\AppData\Local\Programs\Python\Python310\python310.dll";
            
            string pythonRoot = @"C:\Users\Justin\AppData\Local\Programs\Python\Python310";
            // 2. 追加Python根目录到PATH最前面，不覆盖原有PATH
            string originalPath = Environment.GetEnvironmentVariable("PATH", EnvironmentVariableTarget.Process);
            Environment.SetEnvironmentVariable("PATH", $"{pythonRoot};{originalPath}", EnvironmentVariableTarget.Process);
            
            // 3. PYTHONHOME直接指向Python根目录即可
            Environment.SetEnvironmentVariable("PYTHONHOME", pythonRoot, EnvironmentVariableTarget.Process);
            // 4. 补全PYTHONPATH：包含标准库、DLL目录、site-packages、pythonnet目录
            string pythonPath = $@"{pythonRoot}\Lib;{pythonRoot}\DLLs;{pythonRoot}\Lib\site-packages;{pythonRoot}\Lib\site-packages\pythonnet";
            Environment.SetEnvironmentVariable("PYTHONPATH", pythonPath, EnvironmentVariableTarget.Process);

            PythonEngine.PythonHome = pythonRoot;
            PythonEngine.PythonPath = pythonPath;
            
            // 初始化Python引擎
            PythonEngine.Initialize();
            
            // 业务代码示例
            using (Py.GIL())
            {
                dynamic sys = Py.Import("sys");
                Console.WriteLine(sys.version);
            }
            
            // 程序退出前释放引擎
            PythonEngine.Shutdown();
        }
    }
}

WPF应用适配说明 #

• 基础嵌入流程和控制台应用完全一致，核心的路径配置、引擎初始化逻辑可以直接复用
• 需要额外注意2个差异点：
  1. 线程模型适配：WPF主线程默认是STA（单线程单元）模型，而Python运行时初始化需要MTA（多线程单元）环境，建议将Python引擎的初始化、Python代码执行逻辑都放到后台线程执行，避免线程冲突导致崩溃
  2. UI更新限制：不要在执行Python代码的后台线程直接修改WPF控件属性，需要通过Dispatcher调度回UI线程更新界面

内容的提问来源于stack exchange，提问作者Justin