常见目录和文件位置#

Jupyter 将不同的文件（即配置、数据、运行时）存储在多个不同位置。可以设置环境变量来自定义每种文件类型的位置。

Jupyter 将**数据文件**（nbextensions、kernelspecs）与**运行时文件**（日志、pid 文件、连接文件）和**配置**（配置文件、custom.js）分开。

配置文件 #

配置文件默认存储在 ~/.jupyter 目录中。

除了 JUPYTER_CONFIG_DIR，还可以通过 JUPYTER_CONFIG_PATH 指定额外的搜索目录。

JUPYTER_CONFIG_PATH#: 设置此环境变量可为配置搜索路径提供额外的目录。JUPYTER_CONFIG_PATH 应包含一系列目录，这些目录由 ``os.pathsep``（Windows 上为 ;，Unix 上为 :）分隔。

设置 JUPYTER_CONFIG_PATH 的一个示例是，当 notebook 或服务器扩展安装在自定义前缀中时。由于 notebook 和服务器扩展通过配置文件自动启用，因此只有当自定义前缀的 etc/jupyter 目录添加到 Jupyter 配置搜索路径时，自动启用才会起作用。

除了上面提到的用户配置目录，Jupyter 还有一个额外的搜索路径，用于加载配置文件。下表按优先顺序显示了要搜索的位置：

Unix	Windows
`JUPYTER_CONFIG_DIR`
`JUPYTER_CONFIG_PATH`
`{sys.prefix}/etc/jupyter/`
`/usr/local/etc/jupyter/` `/etc/jupyter/`	`%PROGRAMDATA%\jupyter\`

要列出当前正在使用的配置目录，您可以从命令行运行以下命令

jupyter --paths

以下命令专门显示配置目录

jupyter --config-dir

Jupyter 使用搜索路径来查找可安装的数据文件，例如 kernelspecs 和笔记本扩展。当搜索资源时，代码将从第一个目录开始搜索路径，直到找到资源所在的位置。

每种文件类别都在搜索路径中每个目录的一个子目录中。例如，内核规范在 kernels 子目录中。

JUPYTER_PATH#: 设置此环境变量可为数据搜索路径提供额外的目录。JUPYTER_PATH 应包含一系列目录，这些目录由 os.pathsep（Windows 上为 ;，Unix 上为 :）分隔。在其他位置之前搜索 JUPYTER_PATH 中给出的目录。这是除了其他条目之外使用的，而不是替换任何条目。

Linux（及其他自由桌面系统）	Mac	Windows
`JUPYTER_PATH`
`JUPYTER_DATA_DIR` 或（如果未设置）`~/.local/share/jupyter/`（遵循 `$XDG_DATA_HOME`）	`JUPYTER_DATA_DIR` 或（如果未设置）`~/Library/Jupyter`	`JUPYTER_DATA_DIR` 或（如果未设置）`%APPDATA%\jupyter`
`{sys.prefix}/share/jupyter/`
`/usr/local/share/jupyter` `/usr/share/jupyter`		`%PROGRAMDATA\jupyter`

Jupyter 数据文件的配置目录，其中包含非临时、非配置的文件。示例包括内核规范、nbextensions 或 voila 模板。

如上所述，要列出当前正在使用的配置目录，您可以从命令行运行以下命令

jupyter --paths

以下命令专门显示数据目录

jupyter --data-dir

像连接文件这样的东西，只在特定进程的生命周期内有用，有一个运行时目录。

这些运行时文件存储在用户数据目录（上表第二行）的 runtime/ 子目录中。

也可以使用环境变量来设置运行时目录。

如上所述，要列出当前正在使用的配置目录，您可以从命令行运行以下命令

jupyter --paths

以下命令专门显示运行时目录

jupyter --runtime-dir

JUPYTER_CONFIG_DIR 用于配置文件位置

JUPYTER_CONFIG_PATH 用于配置文件位置

JUPYTER_PATH 用于数据文件目录位置

JUPYTER_DATA_DIR 用于数据文件位置

JUPYTER_RUNTIME_DIR 用于运行时文件位置

另请参阅