Bố Trí Thư Mục của Blender (Blender's Directory Layout)

This page documents the different directories used by Blender (which can be helpful for troubleshooting).

There are three different directories Blender may use, their exact locations are platform dependent.

LOCAL:

Location of configuration and run-time data (for self-contained bundle).

USER:

Location of configuration files (typically in the user's home directory).

SYSTEM:

Location of run-time data for system wide installation (may be read-only).

For system installations both SYSTEM and USER directories are needed.

For locally extracted Blender distributions, the user configuration and run-time data are kept in the same subdirectory, allowing multiple Blender versions to run without conflict, ignoring the USER and SYSTEM files. This requires you to create a folder named config in the LOCAL directory.

Platform Dependent Paths

Here are the default locations for each system:

Linux

LOCAL:
./3.6/
USER:
$HOME/.config/blender/3.6/
SYSTEM:
/usr/share/blender/3.6/

Ghi chú

The path ./3.6/ is relative to the Blender executable and is used for self-contained bundles distributed by official blender.org builds.

Ghi chú

The USER path will use $XDG_CONFIG_HOME if it is set:

$XDG_CONFIG_HOME/blender/3.6/

macOS

LOCAL:
./3.6/
USER:
/Users/$USER/Library/Application Support/Blender/3.6/
SYSTEM:
/Library/Application Support/Blender/3.6/

Ghi chú

macOS stores the Blender binary in ./Blender.app/Contents/MacOS/Blender. The local path to data and config is:

./Blender.app/Contents/Resources/3.6/

Cửa Sổ

LOCAL:
.\3.6\
USER:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\
SYSTEM:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\

Ghi chú

For installations from the Window's Store, the USER and SYSTEM directories are inside a special folder resembling: %USERPROFILE%\AppData\Local\Packages\BlenderFoundation.Blender<HASH>\LocalCache\Roaming\Blender Foundation\Blender where "HASH" is a string specific to each installation.

Bố Trí Đường Dẫn (Path Layout)

This is the path layout which is used within the directories described above.

Where ./config/startup.blend could be ~/.blender/|BLENDER_VERSION|/config/startup.blend for example.

./autosave/ ...

Autosave blend-file location. (Windows only, temp directory used for other systems.)

Search order: LOCAL, USER.

./config/ ...

Defaults & session info.

Search order: LOCAL, USER.

./config/startup.blend

Default file to load on startup.

./config/userpref.blend

Default preferences to load on startup.

./config/bookmarks.txt

Các dấu trang cho Trình Duyệt tập tin (Những thư mục được Đánh Dấu, ghi lại).

./config/recent-files.txt

Trình đơn liệt kê tập tin sử dụng gần đây nhất.

./datafiles/ ...

Runtime files.

Search order: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Static precompiled language files for UI translation.

./scripts/ ...

Python scripts for the user interface and tools.

Search order: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Các add-on) Python có thể được kích hoạt trong Cài Đặt Sở Thích Người Dùng bao gồm hỗ trợ định dạng nhập/xuất khẩu, tích hợp bộ máy kết xuất và nhiều thường trình tiện dụng khác.

./scripts/addons/modules/*.py

Những mô-đun mà các Trình Bổ Sung sử dụng (được thêm vào trong sys.path (đường dẫn hệ thống cho các thư viện) của Python).

./scripts/addons_contrib/*.py

Another add-ons directory which is used for community maintained add-ons (must be manually created).

./scripts/addons_contrib/modules/*.py

Modules for addons_contrib to use (added to Python's sys.path).

./scripts/modules/*.py

Các mô đun Python chứa các core API của chúng ta và các hàm Tiện Ích cho các tập lệnh khác để nhập khẩu (được thêm vào trong sys.path của Python).

./scripts/startup/*.py

Các tập lệnh được nhập khẩu tự động khi khởi động.

./scripts/presets/{preset}/*.py

Những sắp đặt sẵn sử dụng để lưu trữ các cài đặt do người dùng xác định cho vải, các định dạng kết xuất, v.v.

./scripts/templates_py/*.py

Các tập lệnh mẫu có thể được truy cập từ Trình Biên Soạn Văn Bản (Text Editor) ‣ Khuôn Mẫu (Templates) ‣ Python.

./scripts/templates_osl/*.osl

Ví dụ về các Bộ Tô Bóng OSL, có thể được truy cập từ Trình Biên Soạn Văn Bản (Text Editor) ‣ Khuôn Mẫu (Templates) ‣ Ngôn Ngữ Tô Bóng Mở (Open Shading Language).

./python/ ...

Bản phân phối có kèm Python.

Search order: LOCAL, SYSTEM.

Thư Mục Bộ Nhớ Đệm Cục Bộ (Local Cache Directory)

The cache directory is used to store persistent caches locally. Currently it is only used for the indexing of Asset Libraries. The operating system is not expected to clear this automatically.

Đường dẫn sau sẽ được sử dụng:

  • Linux:

    $XDG_CACHE_HOME/blender/ if $XDG_CACHE_HOME is set, otherwise $HOME/.cache/blender/

  • macOS:

    /Library/Caches/Blender/

  • Cửa Sổ:

    %USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\

Thư Mục Tạm Thời (Temporary Directory)

Thư mục tạm thời được sử dụng để lưu trữ các tập tin khác nhau trong thời gian phần mềm đang hoạt động (bao gồm các lớp kết xuất, bộ nhớ đệm vật lý, bộ đệm để sao chép và dán, và bản ghi chép sự cố sập đổ).

Thư mục tạm thời được chọn dựa trên mức độ ưu tiên sau:

  • Cấu Hình, (xin xem mục Đường Dẫn Tập Tin (File Paths)).

  • Biến số môi trường ("TEMP" trên Windows, "TMP" & TMP_DIR trên các hệ điều hành khác).

  • Thư mục /tmp/.

Overriding Default Directories

It's possible to override the default USER and SYSTEM directories using environment variables.

While this shouldn't be needed for typical usage, some specialized use cases may take advantage of this, such as:

  • Using a shared network drives for specific paths.

  • Isolating an instance from the default user files to prevent automated tasks from accessing user configuration.

See Biến Số Môi Trường (Environment Variables) for details.