环境准备与目标
背景与目标
在远程开发场景里，将 Jupyter 的工作目录固定到指定路径，可以让笔记本、数据以及训练脚本的引用路径保持一致，减少定位错误的风险。这种做法特别适用于需要在服务器端集中管理大量笔记本和数据集的场景。通过该指南中的多种方案，可以根据实际工作流选择最合适的实现方式。
另一个关键点是确保远程连接稳定、端口通信可用，并且你在远程主机上拥有对目标目录的读写权限。简单来说，目标就是让远程 Jupyter 在你指定的目录中启动，并在 VSCode 的远程环境中无缝访问、编辑和运行笔记本。
路径设计与命名约定
在设计工作目录时，推荐使用统一的命名和分层结构，例如 /home/username/notebooks 作为笔记本根目录，子目录按项目或数据集拆分。一致的目录命名有助于后续的脚本自动化和版本控制。
如果你的模型需要温度参数等配置，建议在笔记本或环境变量中显式设置，避免与工作目录配置混淆。作为示例，温度参数可以通过环境变量传递至代码执行阶段，避免在笔记本内部反复重复设置。
一个常见、可移植的示例是：在远程主机上准备一个专门的工作目录，并在启动 Jupyter 服务器前设置环境变量，以确保各个阶段都能读取到正确的路径和参数。
方案一：通过在远程启动 Jupyter 时指定工作目录
前提条件
确保远程主机上已安装 Python、Jupyter，并且你拥有对目标目录的读写权限。同时，已在本地 VSCode 安装了 Remote - SSH 插件，能够通过 SSH 远程连接到服务器。
在远程环境中，准备一个用于笔记本的固定目录，例如 /home/username/notebooks，作为工作目录的默认落地点。
操作步骤
1) 通过 SSH 连接到远程主机，进入目标工作目录并检查权限：确保目录存在且可写。
ssh user@remote
mkdir -p /home/username/notebooks
chmod 755 /home/username/notebooks
2) 在远程服务器上启动 Jupyter Notebook 时指定工作目录为你期望的路径：--notebook-dir 参数。
jupyter notebook --no-browser --port=8888 --notebook-dir=/home/username/notebooks3) 在本地通过 SSH 端口转发或使用 VSCode 的远程连接来访问该 Jupyter 服务。若使用端口转发，确保能在本地访问到 http://localhost:8888，并通过令牌或密码完成认证。
ssh -L 8888:localhost:8888 user@remote4) 在 VSCode 中配置 Jupyter Server URI 指向本地转发端口，或者直接让 VSCode 的远程扩展通过远程主机连接到 Jupyter。此时，笔记本的默认工作目录即为你指定的目录。
提示：如果你只有一个服务器场景，且经常需要在同一个目录中工作，这种直接指定工作目录的方式最直观、最稳定。
在此方案中，关键点是使用 --notebook-dir 指定目录，确保远程端启动的笔记本就位于该路径。
方案二：通过 VSCode 设置 Notebook 文件根目录
定位设置位置
VSCode 及其 Jupyter 扩展提供了一个方便的全局设置，用于指定“Notebook 文件根目录”，从而将新建笔记本和打开的笔记本默认落在指定路径。这对于远程工作流非常有用，因为你可以让远程工作区的根目录直接成为笔记本根目录。
该方法的好处是无需每次启动 Jupyter 时都传递参数，可以在 VSCode 层面统一管理工作目录。
配置 VSCode
在远程工作区打开后，进入设置，搜索并找到 “Notebook File Root” 的设置项，将其指向远程服务器上的目标路径，例如 /home/username/notebooks。
{"jupyter.notebookFileRoot": "/home/username/notebooks"
}保存设置后，重新加载 VSCode 或重连远程会话。此时新建的笔记本默认就会创建在该目录中，打开已有笔记本时也会在该根目录下定位。
另外一个可选的方式是在工作区设置中覆盖该项，使得不同的工作区可针对不同的工作目录进行个性化配置。
如果你计划将远程服务器作为长期开发环境，本文档中的这一路径也能帮助你在团队协同中实现统一的笔记本位置。
方案三：通过 Jupyter 配置固定默认工作目录
修改远程 Jupyter 配置文件
另一种方式是在远程服务器的 Jupyter 配置中固定默认工作目录。你可以在用户级配置文件 ~/.jupyter/jupyter_notebook_config.py 中设置: c.NotebookApp.notebook_dir。
如果远程环境尚未创建配置文件，可以先生成默认配置再修改。下面给出一个常见的配置片段。
# 在 ~/.jupyter/jupyter_notebook_config.py
c.NotebookApp.notebook_dir = '/home/username/notebooks'4) 保存并重启 Jupyter 服务，使改动生效。此后，无论你从哪个工作目录启动笔记本，默认工作目录都将指向你设定的目录。
重要提示：如果你使用了系统级或服务级的 Jupyter 运行方式，请确保配置文件的路径和权限正确，且不会被其他进程覆盖。
该方案的核心在于让 Jupyter Server 本身知道默认的笔记本根路径，因此对所有通过该服务器访问的客户端都具有一致性。
注意事项与故障排除
检查要点
在应用以上任一方案前，先确认远程主机的 目录权限、磁盘空间与网络连通性，以避免因路径不可写或端口冲突导致的启动失败。
此外，确保你在 VSCode 的远程会话中使用的是同一个工作目录。不同的工作区可能拥有不同的 Notebook File Root 设置，需要逐一核对。
常见问题与解决办法
如果在 VSCode 中打开笔记本时，出现无法创建或定位的错误，请先尝试进行以下检查：1) 重新加载 VSCode，2) 确认远程服务器上的端口转发设置正确，3) 检查目标目录是否仍然存在且可写。
遇到权限问题时，可以在远程主机上临时提升权限或调整目录的属主与权限，确保 当前用户对 /home/username/notebooks 具有写入权限。
若你选择使用方案二的 Notebook File Root，请确保在更改后重新启动 VSCode 的远程连接，以使配置生效。缓存的路径信息可能需要一次完全重连才能更新。
关于温度参数的示例，若你的模型在运行时需要读取温度配置，可以在 notebook 中显式设置环境变量，例如：TEMPERATURE=0.6，以确保运行过程中的行为符合预期。
export TEMPERATURE=0.6import os
os.environ['TEMPERATURE'] = '0.6'这些环境变量与工作目录的设置属于不同的维度，二者可以并行使用来实现稳定、可控的远程运行环境。
