Blender目录布局

本页记录了Blender中用到的几种目录 (对于排查错误有用处)。

Blender使用三种不同的目录，其具体位置与操作系统相关。

LOCAL: 配置和运行时数据位置(用于独立包)。
USER: 配置文件位置(通常位于用户的主目录下)
SYSTEM: 系统级安装的运行时数据位置(可能是只读的)。

对于系统级安装， SYSTEM 和 USER 文件夹都是必需的。

对于本地解压的Blender发行版，这些用户配置数据和运行时数据均位于相同的子文件夹下面，允许Blender的多个版本共存而且不会有冲突，可以忽略 USER 和 SYSTEM 文件。这需要用户自行在 LOCAL 目录创建名为 config 的文件夹。

平台相关路径

下面是各个系统的默认文件夹位置：

Linux

LOCAL

./3.1/

USER

$HOME/.config/blender/3.1/

SYSTEM

/usr/share/blender/3.1/

Note

路径 ./3.1/ 相对于Blender可执行文件位置，用于blender.org 官方编译的独立发行版。

Note

如果设置了 $XDG_CONFIG_HOME， USER 路径会使用该设置:

$XDG_CONFIG_HOME/blender/3.1/

macOS

LOCAL

./3.1/

USER

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

SYSTEM

/Library/Application Support/Blender/3.1/

Note

macOS 的Blender二进制文件存储在 ./Blender.app/Contents/MacOS/Blender ，所以数据和配置的本地路径是:

./Blender.app/Contents/Resources/3.1/

Windows

LOCAL

.\3.1\

USER

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.1\

SYSTEM

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\3.1\

路径布局

下面的路径布局用于上文讲到的目录。

比方说， ./config/startup.blend 指的可能就是 ~/.blender/|BLENDER_VERSION|/config/startup.blend。

./autosave/ ...

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

搜索顺序: LOCAL, USER。

./config/ ...

默认值与会话信息。

搜索顺序: 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。

临时目录

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

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

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