Python会话中Pandas read_parquet可用，VSCode运行报错求助

排查步骤与解决方案 #

1. 强制在VSCode终端重装依赖 #

即使确认了解释器一致，VSCode终端可能未正确激活虚拟环境或存在依赖缓存问题。打开VSCode终端，手动激活虚拟环境：

source /path/to/your/venv/bin/activate

然后重新安装依赖包：

pip install --force-reinstall pyarrow fastparquet

2. 检查VSCode Python扩展配置 #

• 打开命令面板（Ctrl+Shift+P），输入Python: Select Interpreter，再次确认选中目标虚拟环境的解释器。
• 查看项目根目录下的.vscode/settings.json，确保配置指向正确的虚拟环境路径，且自动激活环境：

{
    "python.pythonPath": "/path/to/your/venv/bin/python",
    "python.terminal.activateEnvironment": true
}

若python.terminal.activateEnvironment为false，VSCode终端不会自动激活虚拟环境，会导致依赖查找失败。

3. 验证VSCode终端的环境一致性 #

在VSCode终端执行以下命令，对比交互式会话的输出，确保解释器路径和依赖版本完全一致：

# 查看当前Python路径
which python
# 查看相关包版本
pip list | grep -E "pyarrow|fastparquet|pandas"

若路径不匹配，说明VSCode未正确识别虚拟环境，需重新选择解释器。

4. 清理VSCode缓存 #

VSCode缓存可能导致解释器识别异常：

• 关闭VSCode，删除项目目录下的.vscode文件夹。
• 重新打开VSCode，重新选择虚拟环境解释器后运行代码。

5. 检查版本兼容性 #

不同版本的pandas对pyarrow/fastparquet有版本要求，执行以下命令查看版本：

pip show pandas pyarrow fastparquet

若版本不兼容，可安装兼容性较好的版本组合：

pip install pandas==2.1.0 pyarrow==14.0.0 fastparquet==2023.8.0

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