常見目錄和檔案位置#
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 命令
從命令列查詢這些目錄。