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.
- ЛОКАЛЬНЫЙ:
Место расположения данных конфигурации и работы программы (для автономного пакета).
- ПОЛЬЗОВАТЕЛЬСКИЙ:
Location of configuration files (typically in the user’s home directory).
- СИСТЕМНЫЙ:
Расположение данных работы программы для общесистемной установки (могут быть доступны только для чтения).
Для установки Blender необходимо наличие как СИСТЕМНОГО, так и ПОЛЬЗОВАТЕЛЬСКОГО каталогов.
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.
Пути файлов, в зависимости от ОС
Здесь перечислены пути, определённые по умолчанию для каждой операционной системы:
Linux
- ЛОКАЛЬНЫЙ:
./4.0/
- ПОЛЬЗОВАТЕЛЬСКИЙ:
$HOME/.config/blender/4.0/
- СИСТЕМНЫЙ:
/usr/share/blender/4.0/
Примечание
The path ./4.0/ is relative to the Blender executable and is used for self-contained bundles distributed by official blender.org builds.
Примечание
ПОЛЬЗОВАТЕЛЬСКИЙ путь будет использовать $XDG_CONFIG_HOME
, если установлено:
$XDG_CONFIG_HOME/blender/4.0/
macOS
- ЛОКАЛЬНЫЙ:
./4.0/
- ПОЛЬЗОВАТЕЛЬСКИЙ:
/Users/$USER/Library/Application Support/Blender/4.0/
- СИСТЕМНЫЙ:
/Library/Application Support/Blender/4.0/
Примечание
macOS stores the Blender binary in ./Blender.app/Contents/MacOS/Blender
.
The local path to data and config is:
./Blender.app/Contents/Resources/4.0/
Windows
- ЛОКАЛЬНЫЙ:
.\4.0\
- ПОЛЬЗОВАТЕЛЬСКИЙ:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.0\
- СИСТЕМНЫЙ:
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.0\
Примечание
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.
Расположение путей
Это расположение путей, которые определяются относительно каталогов, упомянутых выше.
Например, путь ./config/startup.blend
откроется в ~/.blender/4.0/config/startup.blend.
./autosave/ ...
Autosave blend-file location. (Windows only, temp directory used for other systems.)
Порядок поиска:
ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ
../config/ ...
Установки по умолчанию и информация о сессии.
Порядок поиска:
ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ
../config/startup.blend
Файл, загружаемый по умолчанию при запуске программы.
./config/userpref.blend
Параметры, загружаемые по умолчанию при запуске программы.
./config/bookmarks.txt
Закладки в обозревателе файлов.
./config/recent-files.txt
Список недавно открытых файлов.
./datafiles/ ...
Файлы работы программы.
Порядок поиска:
ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ, СИСТЕМНЫЙ
../datafiles/locale/{язык}/
Статически скомпилированные языковые файлы для перевода интерфейса программы.
./scripts/ ...
Скрипты на Python’е для инструментов и пользовательского интерфейса.
Порядок поиска:
ЛОКАЛЬНЫЙ, ПОЛЬЗОВАТЕЛЬСКИЙ, СИСТЕМНЫЙ
../scripts/addons/*.py
Python add-ons which may be enabled in the Preferences include import/export format support, render engine integration and many handy utilities.
./scripts/addons/modules/*.py
Modules for add-ons to use (added to Python’s
sys.path
)../scripts/addons_contrib/*.py
Ещё один каталог с дополнениями, который используется для дополнений, поддерживаемых сообществом (должен быть создан вручную).
./scripts/addons_contrib/modules/*.py
Modules for
addons_contrib
to use (added to Python’ssys.path
)../scripts/modules/*.py
Модули Python’а, содержащие наши основные функции API, а также вспомогательные функции для других скриптов, предназначенных для импорта (добавляются к
sys.path
Python’а)../scripts/startup/*.py
Скрипты, которые автоматически импортируются при запуске.
./scripts/presets/{пресет}/*.py
Пресеты, используемые для хранения пользовательских параметров ткани, форматов визуализации и т.д.
./scripts/templates_py/*.py
Примеры скриптов, к которым можно получить доступ из меню
( )../scripts/templates_osl/*.osl
Примеры скриптов, к которым можно получить доступ из меню
( )../python/ ...
Пакетный дистрибутив Python.
Порядок поиска:
ЛОКАЛЬНЫЙ, СИСТЕМНЫЙ
.
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.
The following path will be used:
- Linux:
$XDG_CACHE_HOME/blender/
if$XDG_CACHE_HOME
is set, otherwise$HOME/.cache/blender/
- macOS:
/Library/Caches/Blender/
- Windows:
%USERPROFILE%\AppData\Local\Blender Foundation\Blender\Cache\
Каталог для временных файлов
Каталог временных файлов используется для хранения различных временных файлов во время работы Blender’а (включая: слои визуализации, кэш физики, буфер копирования-вставки и журналы аварийного завершения программы).
Временный каталог выбирается исходя из следующего приоритета:
Установленный в пользовательских настройках (смотрите раздел File Paths).
Environment variables (
TEMP
on Windows,TMP
&TMP_DIR
on other platforms).Каталог
/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 Environment Variables for details.