导入Polars 0.19.7导致Jupyter内核崩溃，求排查原因

常见原因及解决步骤 #

• 版本兼容性问题
  Polars 0.19.7属于较旧版本，可能和你当前使用的Python版本（如3.11及以上）存在兼容冲突。建议：

  • 升级Polars到最新稳定版：

    pip install --upgrade polars
    

  • 若必须保留0.19.7版本，确认Python版本在3.7-3.10范围内（该版本Polars的官方支持版本）。

• Jupyter内核与Polars安装环境不匹配
  常出现内核使用的Python环境和安装Polars的环境不一致的情况。先在Jupyter单元格中运行以下代码确认内核路径：

  import sys
  print(sys.executable)
  

  拿到路径后，用该路径的pip重新安装Polars：

  /输出的路径/python -m pip install polars==0.19.7
  

• 依赖库损坏或缺失
  卸载并重新安装Polars，避免缓存导致的依赖问题：

  pip uninstall -y polars
  pip install polars==0.19.7 --no-cache-dir
  

• 系统架构或底层依赖问题

  • 如果你使用M1/M2芯片的Mac，旧版本Polars对ARM架构支持不完善，建议升级到Polars 0.20+版本。
  • Linux环境下可能缺失底层依赖库，比如安装libgomp1：

    sudo apt-get install libgomp1
    

额外排查手段 #

如果上述方法无效，先在终端直接测试Polars导入：

python -c "import polars; print(polars.__version__)"

• 若终端也崩溃，说明问题出在Polars与系统/Python环境的兼容性，和Jupyter无关；
• 若终端正常运行，说明是Jupyter内核配置问题，需重新安装对应环境的内核：

  /之前输出的路径/python -m ipykernel install --user --name=自定义环境名
  

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