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

Trang này ghi lại các thư mục khác nhau được Blender sử dụng.

This can be helpful for troubleshooting, automation and customization.

Các Thư Mục Người Dùng [User Directories]

User directories store preferences, startup file, installed extensions, presets and more. By default these use the standard configuration folders for each operating system.

Linux

$HOME/.config/blender/4.5/

If the $XDG_CONFIG_HOME environment variable is set:

$XDG_CONFIG_HOME/blender/4.5/

macOS

/Users/$USER/Library/Application Support/Blender/4.5/

Cửa Sổ

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.5\

Cài Đặt Di Động [Portable Installation]

When running Blender from a portable drive, it's possible to keep the configuration files on the same drive to take with you.

To enable this, create a folder named portable at the following locations:

  • Windows: Next to the Blender executable, in the unzipped folder

  • Linux: Next to the Blender executable, in the unzipped folder

  • macOS: Inside the application bundle at Blender.app/Contents/Resources

This folder will then store preferences, startup file, installed extensions and presets.

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

The BLENDER_USER_RESOURCES environment variable can be set to a custom directory to replace the default user directory.

Thư Mục Hệ Thống [System Directories]

System directories store files that come bundled with Blender and are required for it to function. This includes scripts, presets, essential assets and more.

Linux

Bản lưu trữ tải xuống từ blender.org:

./4.5/

Gói phân phối Linux:

/usr/share/blender/4.5/

macOS

./Blender.app/Contents/Resources/4.5/

Cửa Sổ

Tập tin zip tải xuống từ blender.org:

./4.5/

Trình cài đặt tải xuống từ blender.org:

%ProgramFiles%\Blender Foundation\Blender\4.5\

Cài đặt của Microsoft Store:

%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.5\

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

BLENDER_SYSTEM_SCRIPTS and BLENDER_SYSTEM_EXTENSIONS environment variables can be used to bundle additional scripts and extensions, that are not part of the regular Blender installation.

Other BLENDER_SYSTEM environment variables can override other system paths, though are not commonly used in practice.

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

./autosave

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

Nằm trong thư mục người dùng.

./config

User configuration and session info.

Nằm trong thư mục người dùng.

./config/startup.blend

Tập tin Blend để nạp khi khởi động.

./config/userpref.blend

Cài đặt sở thích người dùng.

./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.

./config/{APP_TEMPLATE_ID}/startup.blend

Tập tin khởi động cho mẫu ứng dụng.

./config/{APP_TEMPLATE_ID}/userpref.blend

Tập tin cài đặt sở thích người dùng cho một mẫu ứng dụng.

./datafiles

Data files loaded at runtime.

Located in both user and system directories. User data files either override or add to system data files.

./datafiles/colormanagement

Cấu hình OpenColorIO mặc định.

./datafiles/fonts

Các phông chữ giao diện người dùng.

./datafiles/studiolights

Các hình ảnh ánh sáng studio cho cổng nhìn 3D.

./extensions

Các kho lưu trữ trình mở rộng.

Located in both user and system directories. Repositories are loaded from both directories.

./scripts

Add-ons, presets, templates, user interface, startup scripts.

Located in both user and system directories. Scripts are loaded from both directories.

./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_core/*.py

Thư mục các trình bổ sung vốn sử dụng cho các trình bổ sung được đóng gói cùng.

./scripts/addons_core/modules/*.py

Các mô-đun cho "addons_core" sử dụng (vốn được cộng thêm vào "sys.path" của Python khi tìm thấy).

./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/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

Application templates installed in user directories.

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

pplication templates automatically loaded from system directories.

./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.

Nằm trong thư mục hệ thống.

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/.