使用Panda3D打包Windows可执行文件时Polars二进制缺失问题求助

问题背景 #

构建Panda3D应用时采用Polars替代Pandas，Python环境下运行正常，但打包为Windows可执行文件后，运行出现NameError: name 'PySeries' is not defined错误，同时伴随Polars binary is missing!警告。构建目录中可见polars.polars.pyd文件，但import polars无法正确加载该二进制文件。

代码示例 #

def use_polars():
    """Ensure Polars can find its binary components"""
    try:
        import polars
        # Force initialization of Polars internals
        polars.DataFrame({'test': [1]})  # Simple test to trigger binary loading
        print("Success finding and initializing polars Series")
    except Exception as e:
        print(f"Warning: Polars initialization issue: {e}")
        print("trace")
        print(traceback.format_exc())
        print("trace")
        traceback.print_exc()
        print("trace end") 

错误信息 #

zoneinfo._tzpath:44: InvalidTZPathWarning: Invalid paths specified in PYTHONTZPATH environment variable. Paths should be absolute but found the following relative paths:
    .\share\zoneinfo
polars.meta.build:5: UserWarning: Polars binary is missing!
Warning: Polars initialization issue: name 'PySeries' is not defined
trace
Traceback (most recent call last):
  File "test", line 38, in use_polars
  File "polars.dataframe.frame", line 376, in __init__
  File "polars._utils.construction.dataframe", line 160, in dict_to_pydf
  File "polars._utils.construction.dataframe", line 389, in _expand_dict_values
  File "polars.series.series", line 300, in __init__
  File "polars._utils.construction.series", line 295, in sequence_to_pyseries
NameError: name 'PySeries' is not defined
trace end

解决方案 #

这是Polars在打包场景下的常见问题，核心原因是打包工具未正确识别并包含Polars的二进制依赖文件，可通过以下方式解决：

• 使用打包工具自动收集参数
  若使用PyInstaller，打包时添加--collect-all polars参数，让工具自动收集Polars的所有依赖文件：

  pyinstaller --collect-all polars your_script.py
  

• 手动修改.spec文件
  若已生成.spec文件，添加两项配置：

  1. 在hiddenimports中加入Polars内部模块：

     hiddenimports=['polars.polars']
     

  2. 在datas中指定Polars二进制文件路径（替换为你的Python环境中Polars的实际安装路径）：

     datas=[('path/to/site-packages/polars/polars.pyd', 'polars')]
     

• 手动复制二进制文件
  打包完成后，找到Python环境中site-packages/polars目录下的polars.pyd文件，复制到打包生成的exe所在目录的polars子文件夹中。

• 升级Polars版本
  部分旧版本Polars存在打包兼容性问题，升级到最新稳定版可解决此类问题：

  pip install --upgrade polars
  

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