常见目录和文件位置#
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 --paths
以下命令专门显示配置目录
jupyter --config-dir
数据文件#
Jupyter 使用搜索路径来查找可安装的数据文件,例如 kernelspecs 和笔记本扩展。当搜索资源时,代码将从第一个目录开始搜索路径,直到找到资源所在的位置。
每种文件类别都在搜索路径中每个目录的一个子目录中。例如,内核规范在 kernels
子目录中。
- JUPYTER_PATH#
设置此环境变量可为数据搜索路径提供额外的目录。
JUPYTER_PATH
应包含一系列目录,这些目录由os.pathsep
(Windows 上为;
,Unix 上为:
)分隔。在其他位置之前搜索JUPYTER_PATH
中给出的目录。这是除了其他条目之外使用的,而不是替换任何条目。
Linux(及其他自由桌面系统) |
Mac |
Windows |
---|---|---|
|
|
|
|
||
|
|
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 命令
从命令行查找这些目录。