VSCode中远程Jupyter服务器搭配远程Notebook文件运行问题

步骤1：确保远程主机的Jupyter环境就绪 #

• 在远程Ubuntu 22.04上，确认已安装Jupyter和目标Python环境：
  • 检查Jupyter版本：jupyter --version
  • 未安装则执行：pip install jupyter（若使用conda环境，先激活环境再执行conda install jupyter）
• 确保远程Python环境（系统Python或conda虚拟环境）已安装项目所需依赖包

步骤2：在VSCode远程会话中安装Jupyter扩展 #

• 通过Remote SSH连接到远程主机后，打开VSCode扩展面板（Ctrl+Shift+X）
• 找到Jupyter扩展，点击「Install in SSH: [你的远程主机名]」，确保扩展安装在远程端（而非本地）

步骤3：选择远程kernel运行Notebook #

• 在VSCode中打开远程文件夹中的.ipynb文件
• 点击右上角的「Select Kernel」按钮
• 在弹出的选项列表中，直接选择远程主机上的Python环境（比如Python 3.10.6 (/usr/bin/python3)或你的conda虚拟环境名称）
• 选择后，VSCode会自动在远程启动对应的Jupyter kernel，无需手动启动远程server并粘贴URL

备选方案：手动指定远程Jupyter Server（自动识别失败时） #

• 在远程主机上手动启动Jupyter Server，执行命令：

  jupyter notebook --no-browser --port=8888
  

• 复制输出中的完整URL（包含token参数，格式如http://localhost:8888/?token=xxxxxx）
• 回到VSCode的Notebook界面，点击「Select Kernel」→「Existing Jupyter Server...」
• 粘贴刚才复制的完整URL，点击「Connect」
• 此时VSCode会连接到远程的Jupyter Server，同时使用远程的Notebook文件和kernel

注意事项 #

• 确保远程主机的8888端口（或你指定的其他端口）未被占用，若占用可换用其他端口（如--port=8889）
• 若使用conda虚拟环境，需先在远程主机激活环境再启动Jupyter Server，或在VSCode中直接选择激活后的虚拟环境作为kernel

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