Blender 目录布局

本页记录了 Blender 使用的不同目录 （对于排查错误有帮助）。

Blender 可能会使用三个不同的目录，它们的具体位置取决于平台。

LOCAL:: 配置和运行时数据的位置（针对独立捆绑包）。
USER:: 配置文件的位置（通常位于用户的主目录下）。
SYSTEM:: Location of run-time data for system wide installation (may be read-only).

安装系统时，需要 SYSTEM 和 USER 两个目录。

对于本地解压的 Blender 发行版，用户配置和运行时数据被保存在同一个子目录中，这样多个 Blender 版本在运行时就不会发生冲突，同时忽略了 USER 和 SYSTEM 文件。这就需要在 LOCAL 目录下创建一个名为 config 的文件夹。

平台相关路径

以下是各系统的默认位置：

Linux

LOCAL:

./3.6/

USER:

$HOME/.config/blender/3.6/

SYSTEM:

/usr/share/blender/3.6/

Note

路径 ./3.6/ 是 Blender 可执行文件的相对路径，用于官方 blender.org 编译发布的独立捆绑包。

Note

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/

Note

macOS 将 Blender 二进制文件存储在 ./Blender.app/Contents/MacOS/Blender 中。数据和配置的本地路径是：

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

Windows

LOCAL:

.\3.6\

USER:

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\

SYSTEM:

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.6\

Note

对于从 Window's 商店安装的程序，USER 和 SYSTEM 目录位于一个特殊文件夹内，该文件夹类似于：%USERPROFILE%\AppData\Local\Packages\BlenderFoundation.Blender<HASH>\LocalCache\Roaming\Blender Foundation\Blender，其中 "HASH" 是每个安装程序特有的字符串。

路径布局

这是上述目录中使用的路径布局。

例如，./config/startup.blend 可以是 ~/.blender/|BLENDER_VERSION|/config/startup.blend 。

./autosave/ ...

自动保存 blend 文件位置。（仅限 Windows，其他操作系统位于临时文件目录。）

搜索顺序：LOCAL, USER。

./config/ ...

Defaults & session info.

搜索顺序：LOCAL, USER。

./config/startup.blend

启动时加载的默认文件。

./config/userpref.blend

启动时加载的默认偏好设置。

./config/bookmarks.txt

文件浏览器书签。

./config/recent-files.txt

最近打开的文件列表。

./datafiles/ ...

运行时文件。

搜索顺序：LOCAL, USER, SYSTEM。

./datafiles/locale/{language}/

用于用户界面翻译的静态预编译语言文件。

./scripts/ ...

用户界面和工具的 Python 脚本。

搜索顺序：LOCAL, USER, SYSTEM。

./scripts/addons/*.py

可以在用户设置启用的 Python 插件，包括导入/导出格式支持、渲染引擎集成和许多方便的工具。

./scripts/addons/modules/*.py

插件用到的模块（添加到 Python 的 sys.path）。

./scripts/addons_contrib/*.py

另一个插件目录，用于社区维护的插件（必须手动创建）。

./scripts/addons_contrib/modules/*.py

供 addons_contrib 使用的模块（添加到 Python 的 sys.path）。

./scripts/modules/*.py

包含核心 API 和工具函数的 Python 模块，供其他脚本导入（添加到 Python 的 sys.path）。

./scripts/startup/*.py

启动时将自动载入的脚本。

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

预设文件，用于存储用户定义的布料、渲染格式等设置。

./scripts/templates_py/*.py

可以从文本编辑器 ‣ 模板 ‣ Python 访问的示例脚本。

./scripts/templates_osl/*.osl

可以从文本编辑器 ‣ 模板 ‣ 开放式着色语言（OSL）访问的 OSL 着色器示例。

./python/ ...

绑定的 Python 发行版。

搜索顺序：LOCAL, SYSTEM。

本地缓存目录

缓存目录用于在本地存储永久缓存。目前它仅用于资产库的索引。操作系统不会自动清除此内容。

将使用以下路径：

Linux:

如果设置了 $XDG_CACHE_HOME，则为 $XDG_CACHE_HOME，否则为 $HOME/.cache/blender/
macOS:

/Library/Caches/Blender/
Windows:

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

临时目录

临时目录用于存储各种运行时文件（包括渲染层、物理缓存、复制-粘贴缓存和崩溃日志）。

临时目录的选择基于以下优先级：

用户设置（见文件路径）。
环境变量（Windows 为 TEMP，其他平台为 TMP 或 TMP_DIR）。
/tmp/ 目录。

覆盖默认目录

使用环境变量可以覆盖默认的 USER 和 SYSTEM 目录。

虽然在一般情况下不需要这样做，但某些特殊用例可能会利用这一点，例如：

将共享网络驱动器用于特定路径。
将实例与默认用户文件隔离，防止自动化任务访问用户配置。

详情请参阅环境变量。