Debian12下VS Code远程Jupyter Notebook的Pandas导入警告与环境配置问题

核心问题根源 #

Debian12遵循PEP668默认禁止pip全局安装包，必须使用虚拟环境隔离依赖；同时VS Code远程窗口未正确关联虚拟环境，导致Pylance语法分析、环境切换栏与Jupyter运行环境不匹配。

步骤1：创建并配置虚拟环境 #

• 安装完整Python工具链（确保venv模块可用）：

  sudo apt install python3-full
  

• 进入项目工作目录，创建虚拟环境（示例命名为venv）：

  python3 -m venv venv
  

• 激活虚拟环境：

  source venv/bin/activate
  

• 在虚拟环境内安装所需依赖：

  pip install pandas jupyter ipykernel
  

步骤2：让VS Code识别虚拟环境并显示切换栏 #

• 远程连接服务器后，打开VS Code命令面板（Ctrl+Shift+P），输入Python: Select Interpreter，选择虚拟环境路径./venv/bin/python。
• 若状态栏未显示环境组件：
  • 打开扩展面板，搜索Python Extension Pack，确认扩展安装在远程服务器上（而非本地Windows），未安装则点击Install in SSH: [你的服务器名]。
  • 重启VS Code远程窗口，状态栏会出现环境指示器。

步骤3：关联Jupyter内核与虚拟环境 #

• 保持虚拟环境激活状态，注册虚拟环境为Jupyter内核：

  python -m ipykernel install --user --name=venv-kernel --display-name="Python (venv)"
  

• 打开Jupyter Notebook，点击右上角内核选择器，选择Python (venv)。
• 此时Notebook运行环境与Pylance分析环境一致，Import "pandas" could not be resolved from source警告会消失。

验证配置 #

• 重新运行Notebook代码，确认正常执行。
• 检查VS Code状态栏，确认能看到当前虚拟环境并可切换。

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