C#调用Python报错Runtime.PythonDLL未设置或指向不支持的Python运行时DLL的问题求助

大家好，我最近在尝试用C#结合Python.Runtime库调用本地Python环境，写了如下代码：

using Python.Runtime;
using System;

class Program
{
    static void Main()
    {
        try
        {
            // Set Python home and DLL paths
            PythonEngine.PythonHome = @"C:\Users\toto\AppData\Local\Programs\Python\Python311";
            Runtime.PythonDLL = @"C:\Users\toto\AppData\Local\Programs\Python\Python311\python311.dll";

            // Initialize the Python engine
            PythonEngine.Initialize();

            using (Py.GIL())
            {
                // Import and use Python modules
                dynamic sys = Py.Import("sys");
                Console.WriteLine($"Python version: {sys.version}");
            }

            // Shutdown the Python engine
            PythonEngine.Shutdown();
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

但运行后控制台直接抛出了错误：

Error: Runtime.PythonDLL was not set...

我明明已经按照文档要求设置了PythonHome和PythonDLL的路径，却还是遇到这个问题，有没有大佬能帮忙分析下可能的原因和解决办法？

整理自社区的常见排查与解决思路 #

• 路径准确性核验：先手动确认python311.dll的路径是否完全正确，比如有没有拼写错误、是否混淆了Python的安装版本（比如误把3.10的路径写到了3.11的配置里）。可以直接打开文件资源管理器定位到该路径，确保DLL文件确实存在。
• 版本兼容性匹配：检查你安装的Python.Runtime NuGet包版本是否和本地Python版本兼容——比如Python 3.11需要对应支持3.11的Python.Runtime版本，版本不匹配大概率会出现这类加载失败的问题。
• 运行位数一致性检查：确保你的C#项目平台目标（x86/x64/Any CPU）和本地Python的位数完全一致。如果Python是64位，C#项目就要设为x64；如果是32位Python，项目就要设为x86；若用Any CPU，记得勾选“首选32位”来匹配对应位数的Python。
• 手动加载DLL排查：可以尝试在设置Runtime.PythonDLL后，手动调用NativeLibrary.Load(Runtime.PythonDLL)强制加载DLL，这样能抛出更具体的错误信息，方便定位问题。
• 补充环境变量设置：除了设置PythonEngine.PythonHome，还可以在代码开头补充环境变量配置，确保系统能找到Python相关依赖：

  Environment.SetEnvironmentVariable("PYTHONHOME", @"C:\Users\toto\AppData\Local\Programs\Python\Python311");
  Environment.SetEnvironmentVariable("PATH", Environment.GetEnvironmentVariable("PATH") + @";C:\Users\toto\AppData\Local\Programs\Python\Python311;C:\Users\toto\AppData\Local\Programs\Python\Python311\DLLs");
  

• 权限问题排查：如果Python安装在系统盘，尝试以管理员身份运行你的C#程序，确认是否是权限不足导致无法读取DLL文件。

备注：内容来源于stack exchange，提问作者shiny