如何在VS Code开发容器中设置Jupyter Notebook的起始工作目录

以下是几种无需手动修改单个笔记本的优雅配置方式：

1. 通过devcontainer.json配置VS Code Jupyter扩展 #

直接在devcontainer.json中指定Jupyter笔记本的根目录为工作区文件夹，这是适配VS Code集成场景的最优方案：

"customizations": {
  "vscode": {
    "settings": {
      "jupyter.notebookFileRoot": "${workspaceFolder}"
    }
  }
}

该设置会让VS Code的Jupyter扩展自动将所有笔记本的起始工作目录绑定到容器内的/workspace（即本地映射的工作区路径）。

2. 在Dockerfile中预配置Jupyter默认目录 #

通过Dockerfile生成Jupyter的配置文件，确保容器启动后Jupyter服务默认指向/workspace：

# 针对root用户配置
RUN mkdir -p /root/.jupyter && \
    echo "c.NotebookApp.notebook_dir = '/workspace'" >> /root/.jupyter/jupyter_notebook_config.py

# 如果使用非root用户（如vscode用户），替换为对应路径并调整权限
# RUN mkdir -p /home/vscode/.jupyter && \
#     echo "c.NotebookApp.notebook_dir = '/workspace'" >> /home/vscode/.jupyter/jupyter_notebook_config.py && \
#     chown -R vscode:vscode /home/vscode/.jupyter

这种方式直接控制Jupyter服务本身的启动目录，不受VS Code扩展的额外影响。

3. 通过postCreateCommand动态生成配置 #

若不想修改Dockerfile，可在devcontainer.json的postCreateCommand中添加配置命令，容器创建后自动生成Jupyter配置：

"postCreateCommand": "mkdir -p ~/.jupyter && echo \"c.NotebookApp.notebook_dir = '/workspace'\" >> ~/.jupyter/jupyter_notebook_config.py"

~会自动解析为当前容器用户的主目录，无需手动指定路径。

为什么单独设置WORKDIR无效？ #

Docker的WORKDIR仅控制容器启动时的默认工作目录，但Jupyter Notebook服务的起始目录由自身配置文件或VS Code Jupyter扩展的独立设置控制，不会继承Docker的WORKDIR参数，因此单独设置WORKDIR无法解决该问题。

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