VS Code通过SSH连远程服务器时不显示Conda Python 2环境怎么办？

1. 为Python 2环境手动安装并注册ipykernel #

VS Code的Jupyter内核识别依赖ipykernel，多数Python 2 Conda环境默认不会预装这个包，需要手动操作：

# 激活目标Python 2环境
conda activate your_py2_env_name
# 用Python 2专属pip安装ipykernel
pip2 install ipykernel
# 将环境注册为Jupyter可识别的内核
python2 -m ipykernel install --user --name=your_py2_env_name --display-name="Python 2 (your_py2_env_name)"

替换your_py2_env_name为你的实际环境名称，比如py27。

2. 检查VS Code Jupyter扩展的过滤设置 #

VS Code的Jupyter扩展可能默认过滤Python 2内核，需要调整：

• 打开VS Code设置（快捷键Ctrl+,/Cmd+,）
• 搜索jupyter.kernels.filter，确认exclude列表为空，无Python 2相关排除规则
• 若存在过滤规则，直接清空exclude数组，或添加如下配置到settings.json：

"jupyter.kernels.filter": {
    "exclude": []
}

3. 刷新或重启Jupyter服务 #

完成上述操作后：

• 在VS Code的Jupyter界面，点击内核选择框右侧的刷新图标
• 若仍不显示，点击左下角状态栏的Jupyter图标，选择Restart Jupyter Server重启服务

4. 验证内核注册状态 #

在远程服务器终端执行以下命令，确认Python 2内核已被Jupyter识别：

jupyter kernelspec list

如果输出中能看到你注册的Python 2环境，说明注册成功，VS Code应能同步识别。

5. 校准VS Code远程环境变量 #

VS Code远程连接时的环境变量可能和本地终端不一致，导致无法找到Python 2环境：

• 在VS Code的远程终端执行echo $PATH和which python2，对比本地终端的输出
• 若路径不一致，在VS Code的settings.json中添加远程环境变量配置：

"terminal.integrated.env.linux": {
    "PATH": "/home/your_username/miniconda2/bin:$PATH"
}

替换/home/your_username/miniconda2/bin为你的Conda实际安装路径。

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