VSCode数据查看器提示需pandas 0.20.0以上但实际版本为2.0.3的问题求助

问题现象 #

• 新conda环境（Mac M1）已安装pandas 2.0.3、scikit-learn，但VSCode数据查看器始终弹出“需pandas 0.20.0及以上版本”错误，升级/降级pandas均无法解决
• 旧conda环境可正常使用数据查看器，但无法读取新版pandas保存的pickle文件，更新旧环境会触发大量依赖冲突
• 运行代码时弹出Intel MKL警告：

Intel MKL WARNING: Support of Intel(R) Streaming SIMD Extensions 4.2 (Intel(R) SSE4.2) enabled only processors has been deprecated. Intel oneAPI Math Kernel Library 2025.0 will require Intel(R) Advanced Vector Extensions (Intel(R) AVX) instructions.

排查日志（新环境Jupyter扩展日志） #

Visual Studio Code (1.81.1, undefined, desktop)
Jupyter Extension Version: 2023.7.1002162226.
Python Extension Version: 2023.14.0.
Platform: darwin (arm64).
14:58:37.322 [info] User belongs to experiment group 'FastKernelPicker'
14:58:37.322 [info] User belongs to experiment group 'NewRemoteUriStorage'
14:58:37.322 [info] User belongs to experiment group 'PasswordManager'
14:58:37.322 [info] User belongs to experiment group 'NewJupyterSession'
14:58:38.239 [info] Start refreshing Kernel Picker (1694440718239)
14:58:38.253 [info] Using Pylance
14:58:43.585 [info] End refreshing Kernel Picker (1694440718239)
14:58:59.475 [info] Process Execution: ~/opt/anaconda3/envs/my_env/bin/python -m pip list
14:59:50.126 [info] Found debugAdapterPython on Debug Configuration to use
14:59:50.164 [info] Process Execution: ~/opt/anaconda3/envs/my_env/bin/python -c "import pandas;print(pandas.version)"
15:01:10.224 [error] [Error: Python package 'pandas' version 0.20.0 (or above) is required for viewing data.
at tP.promptInstall (~/.vscode/extensions/ms-toolsai.jupyter-2023.7.1002162226-darwin-arm64/out/extension.node.js:24:601008)]
15:01:10.228 [warn] DataScience Error [Error: Python package 'pandas' version 0.20.0 (or above) is required for viewing data.
at tP.promptInstall (~/.vscode/extensions/ms-toolsai.jupyter-2023.7.1002162226-darwin-arm64/out/extension.node.js:24:601008)]
15:01:19.813 [info] Ending debug session 7f3759e6-c428-4aa5-b3e8-ac017a77fa34

问题根源分析 #

1. VSCode扩展环境关联异常：从日志可见，Jupyter扩展执行pandas版本检测时，未正确关联当前conda环境的Python解释器，导致无法识别已安装的高版本pandas，M1的arm64架构可能加剧了这种兼容性问题。
2. Intel MKL架构不兼容：M1为ARM架构，不支持Intel AVX指令集，而scikit-learn依赖的MKL库是针对x86编译的，这可能间接导致Python依赖加载异常，干扰pandas版本检测。
3. 新旧环境格式与依赖冲突：旧环境pandas版本过低，与新版pandas的pickle格式不兼容；且旧环境依赖链老化，更新时易引发冲突。

解决步骤 #

修复数据查看器版本误报 #

• 强制指定Python解释器：
  1. 打开VSCode命令面板（Cmd+Shift+P），输入Python: Select Interpreter
  2. 手动选择当前conda环境的Python路径（如~/opt/anaconda3/envs/my_env/bin/python）
  3. 重启VSCode后测试数据查看器
• 调整Jupyter扩展版本：
  1. 卸载当前Jupyter扩展（2023.7.1002162226）
  2. 安装最新稳定版或回退到2023.6.x版本（部分M1用户反馈旧版本兼容性更好）
• 验证环境关联：在VSCode终端执行以下命令，确认pandas版本：

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

  确保输出为2.0.3，若不一致则说明环境未切换成功。

解决MKL警告与依赖问题 #

• 创建ARM兼容的conda环境：
  使用conda-forge频道安装原生arm64架构的库，避免Intel MKL的兼容性问题：

  conda create -n my_env_arm python=3.10 -c conda-forge
  conda activate my_env_arm
  conda install pandas=2.0.3 scikit-learn -c conda-forge
  

• 兼容旧环境读取新版pickle：
  在旧环境中安装pickle5库，适配新版pandas的pickle格式：

  pip install pickle5
  

  读取文件时修改代码：

  import pickle5 as pickle
  df = pickle.load(open("your_file.pkl", "rb"))
  

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