PyVista程序在Windows 10无法显示窗口问题求助

1. 图形API兼容性问题 #

PyVista依赖VTK，而VTK默认调用OpenGL渲染。Windows 10的显卡驱动OpenGL版本可能偏低，或者部分老显卡在Win10上的OpenGL支持不全；另外，新版本PyVista可能启用了Win11专属的图形特性，Win10不兼容。

解决：

• 强制启用软件渲染绕开硬件限制，在初始化PyVista前加这段代码：

  import pyvista as pv
  pv.global_theme.force_software_rendering = True
  

• 让Win10用户更新显卡驱动，确保OpenGL版本不低于3.3（PyVista最低要求）。

2. 打包时缺失Win10必需的依赖库 #

Inno Setup打包时可能只打包了Win11环境下的依赖，Win10缺少VC++运行库、.NET Framework或者VTK/Qt的核心依赖文件（如果用了Qt做UI）。

解决：

• 在Inno安装包中加入VC++ 2019/2022 redistributable（根据你打包用的Python对应的编译器选择），设为必装项。
• 如果是用PyInstaller生成的exe，打包时加--collect-all pyvista和--collect-all vtk参数，确保所有依赖文件被完整收集。
• 检查Win10系统是否装了.NET Framework 4.8，没装的话把它集成到安装包。

3. 系统权限或安全拦截 #

Win10的UAC权限、杀毒软件可能阻止PyVista创建渲染窗口，或者限制了图形资源访问。

解决：

• 让用户右键程序选「以管理员身份运行」测试。
• 临时关闭Win10的杀毒软件/Windows Defender实时保护，排查是否是拦截导致。
• 在Inno Setup脚本里加权限设置：

  [Setup]
  PrivilegesRequired=admin
  

4. PyVista/VTK版本不兼容Win10 #

你用的PyVista或VTK新版本可能已经放弃对Win10的支持，只适配Win11。

解决：

• 降级PyVista到0.43.0及以下，VTK到9.2.6及以下（这些版本明确支持Win10），重新打包测试。

5. DPI缩放适配问题 #

Win10的高DPI缩放设置可能导致PyVista渲染窗口初始化失败。

解决：

• 让用户在程序快捷方式属性里勾选「高DPI缩放替代」，选择「应用程序」模式。
• 在代码里加DPI感知设置：

  import ctypes
  ctypes.windll.shcore.SetProcessDpiAwareness(2)
  

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