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

Trang này viết về các thư mục khác nhau mà Blender sử dụng (tức những cái có thể trở nên hữu dụng trong việc xử lý sự cố ).

Có ba thư mục khác biệt mà Blender có thể sử dụng. Vị trí chính xác của chúng ở đâu còn tùy thuộc vào hệ điều hành sử dụng nữa.

Cục Bộ (LOCAL)

Đây là địa phương của cấu hình và dữ liệu sử dụng trong khi phần mềm đang hoạt động (dành cho gói độc lập).

USER

Đây là địa phương của các tập tin cấu hình (thường nằm trong thư mục chính (thư mục nhà riêng của người dùng).

SYSTEM

Đây là địa phương của dữ liệu sử dụng trong thời gian chạy, dành cho sự cài đặt trên toàn hệ thống ( có thể read-only mà thôi).

Để cài đặt hệ thống, cả hai thư mục "SYSTEM" và "USER" đều cần thiết.

Đối với các bản phân phối Blender được Trích Xuất Cục Bộ, cấu hình người dùng và dữ liệu hoạt động run-time được lưu giữ trong cùng thư mục nhánh, cho phép nhiều phiên bản Blender cùng hoạt động một lúc mà không gây ra xung đột. Chúng sẽ bỏ qua các tập tin "USER" và "SYSTEM". Cái này đòi hỏi bạn phải kiến tạo một thư mục với tên là 'config' trong thư mục "LOCAL".

Những Đường Dẫn Phụ Thuộc Nền Tảng (Platform Dependent Paths)

Dưới đây là các vị trí mặc định cho mỗi hệ thống:

Linux

Cục Bộ (LOCAL)
./3.4/
USER
$HOME/.config/blender/3.4/
SYSTEM
/usr/share/blender/3.4/

Ghi chú

Đường dẫn ./3.4/ nằm tương đối với:abbr:bản Thực thi Blender (Blender executable: bản nhị phân, thi hành được) và được sử dụng cho các gói độc lập, được phân phối qua các phiên bản do blender.org xây dựng.

Ghi chú

Đường dẫn "USER" sẽ sử dụng biến môi trường $XDG_CONFIG_HOME, nếu nó được đã thiết lập:

$XDG_CONFIG_HOME/blender/3.4/

macOS

Cục Bộ (LOCAL)
./3.4/
USER
/Users/$USER/Library/Application Support/Blender/3.4/
SYSTEM
/Library/Application Support/Blender/3.4/

Ghi chú

macOS lưu trữ bản blender nhị phân trong thư mục ./Blender.app/Contents/MacOS/Blender, do đó, đường dẫn cục bộ đến dữ liệu và cấu hình là:

./Blender.app/Contents/Resources/3.4/

Windows

Cục Bộ (LOCAL)
.\3.4\
USER
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.4\
SYSTEM
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.4\

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

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

Đây là cách bố trí đường dẫn sử dụng trong các thư mục được miêu tả ở trên.

Trong khi đó ./config/startup.blend có thể nằm tại ~/.blender/|BLENDER_VERSION|/config/startup.blend chẳng hạn.

./autosave/ ...

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

Thứ tự lùng tìm: LOCAL, USER.

./config/ ...

Mặc định & thông tin về phiên sử dụng.

Thứ tự lùng tìm: LOCAL, USER.

./config/startup.blend

Tập tin mặc định để nạp nạp vào bộ nhớ khi khởi động.

./config/userpref.blend

Các tùy chọn mặc định để nạp vào bộ nhớ khi khởi độ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.

./datafiles/ ...

Những tập tin sử dụng trong khi phần mềm đang chạy.

Thứ tự lùng tìm: LOCAL, USER, SYSTEM.

./datafiles/locale/{language}/

Các tập tin Ngôn ngữ tĩnh biên dịch trước dành cho sự phiên dịch Giao Diện Người Dùng.

./scripts/ ...

Các tập lệnh Python cho giao diện người dùng và các công cụ.

Thứ tự lùng tìm: LOCAL, USER, SYSTEM.

./scripts/addons/*.py

Các add-on)` Python có thể được kích hoạt trong Cấu Hình Người Dùng bao gồm hỗ trợ định dạng nhập/xuất, 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 cộng 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

Đây là một thư mục dành cho các Trình Bổ Sung và được sử dụng cho các Trình Bổ Sung do cộng đồng quản lý (phải do mình tạo ra một cách thủ công).

./scripts/addons_contrib/modules/*.py

Các mô-đun dành cho addons_contrib sử dụng (được thêm vào trong sys.path của Python).

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

Thứ tự lùng tìm: LOCAL, SYSTEM.

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

The cache directory is used to store persistent chaches 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/Chaches/Blender/

  • Windows

    %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:

Vượt Quyền Thư Mục Mặc Định (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.