如何在VS Code中通过Docker容器内虚拟环境运行Jupyter并打开ipynb文件

1. 让VS Code连接到服务器上的Docker容器 #

• 确保VS Code已安装Remote - SSH和Docker扩展。
• 如果你已经通过Remote-SSH连接到远程服务器，直接在VS Code左侧的Docker面板里找到目标容器，右键选择Attach Visual Studio Code，就能进入容器内部的开发环境。

2. 在容器内的虚拟环境中配置Jupyter #

• 打开VS Code终端（此时终端默认是容器内的shell），先激活你的Python虚拟环境：

  # 替换成你实际的虚拟环境路径
  source /path/to/your/venv/bin/activate
  

• 激活环境后，安装Jupyter和内核依赖：

  pip install jupyter ipykernel
  

• 把当前虚拟环境注册为Jupyter可识别的内核：

  python -m ipykernel install --user --name=custom_venv_kernel --display-name "Python (容器内虚拟环境)"
  

  这里的custom_venv_kernel是内核的内部名称，display-name是VS Code里显示的名称，按需修改即可。

3. 在VS Code中使用虚拟环境运行ipynb #

• 在容器内的VS Code中打开目标ipynb文件。
• 点击右上角的内核选择按钮（通常显示当前默认内核，比如"Python 3.9.7"），在下拉列表里找到你刚才注册的Python (容器内虚拟环境)并选中。
• 现在运行单元格时，代码就会在容器内的虚拟环境中执行了。

额外提示 #

• 不需要额外映射Jupyter的端口，因为VS Code是直接attach到容器内部，通过本地通信调用Jupyter服务，不会暴露外部端口。
• 如果遇到内核启动失败，检查虚拟环境的Python版本和ipykernel版本是否兼容，或者重新执行内核注册命令。

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