常见目录和文件位置#

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

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

配置文件#

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

JUPYTER_CONFIG_DIR#

设置此环境变量,以使用除默认目录以外的特定目录来存储 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_DATA_DIR#

设置此环境变量可使用除默认目录以外的特定目录作为用户数据目录。

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

jupyter --paths

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

jupyter --data-dir

运行时文件#

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

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

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

JUPYTER_RUNTIME_DIR#

设置此项可覆盖 Jupyter 存储运行时文件的位置。

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

jupyter --paths

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

jupyter --runtime-dir

总结#

JUPYTER_CONFIG_DIR 用于配置文件位置

JUPYTER_CONFIG_PATH 用于配置文件位置

JUPYTER_PATH 用于数据文件目录位置

JUPYTER_DATA_DIR 用于数据文件位置

JUPYTER_RUNTIME_DIR 用于运行时文件位置

另请参阅

jupyter_core.paths

用于查找这些目录的 Python API。

jupyter 命令

从命令行查找这些目录。