Blender 目录布局

本页记录了 Blender 使用的不同目录。

这有助于故障排除、自动化和定制。

用户目录

用户目录存储偏好设置、启动文件、已安装的扩展、预设等。默认情况下，这些目录使用每个操作系统的标准配置文件夹。

Linux

$HOME/.config/blender/4.3/

如果设置了 $XDG_CONFIG_HOME 环境变量：

$XDG_CONFIG_HOME/blender/4.3/

macOS

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

Windows

%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.3\

便携安装

在便携式硬盘上运行 Blender 时，可以将配置文件保存在同一硬盘上，以便随身携带。

要启用此功能，请在以下位置创建名为 portable 的文件夹：

  • Windows：在已解压文件夹中的 Blender 可执行文件旁

  • Linux：在已解压文件夹中的 Blender 可执行文件旁

  • macOS：应用程序捆绑包内的 Blender.app/Contents/Resources

该文件夹将存储偏好设置、启动文件、已安装的扩展和预设。

环境变量

可以将 BLENDER_USER_RESOURCES 环境变量设置为自定义目录，以替换默认用户目录。

系统目录

系统目录存储 Blender 附带的文件，这些文件是 Blender 正常运行所必需的。其中包括脚本、预设、基本资产等。

Linux

从 blender.org 下载的文件：

./4.3/

Linux 发行版软件包：

/usr/share/blender/4.3/

macOS

./Blender.app/Contents/Resources/4.3/

Windows

从 blender.org 下载的 Zip 文件：

./4.3/

从 blender.org 下载的安装包：

%ProgramFiles%\Blender Foundation\Blender\4.3\

Microsoft 商店安装：

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

环境变量

BLENDER_SYSTEM_SCRIPTS 和 BLENDER_SYSTEM_EXTENSIONS 环境变量可以用来捆绑附加的脚本和扩展，它们不是常规 Blender 安装的一部分。

其他 BLENDER_SYSTEM 环境变量可以覆盖其他系统路径，但实际上并不常用。

路径布局

./autosave

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

位于用户目录中。

./config

用户配置与会话信息。

位于用户目录中。

./config/startup.blend

启动时载入的 blend 文件。

./config/userpref.blend

用户偏好设置。

./config/bookmarks.txt

文件浏览器书签。

./config/recent-files.txt

最近打开的文件列表。

./config/{APP_TEMPLATE_ID}/startup.blend

应用模板的启动文件。

./config/{APP_TEMPLATE_ID}/userpref.blend

应用模板的用户偏好设置文件。

./datafiles

运行时加载的数据文件。

位于用户和系统目录中。用户数据文件可以覆盖或添加到系统数据文件中。

./datafiles/colormanagement

默认的 OpenColorIO 配置。

./datafiles/fonts

用户界面字体。

./datafiles/studiolights

用于 3D 视口的棚灯图像。

./extensions

扩展存储库。

位于用户和系统目录中。存储库从这两个目录中加载。

./scripts

插件、预设、模板、用户界面、启动脚本。

位于用户和系统目录中。脚本从这两个目录中加载。

./scripts/addons/*.py

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

./scripts/addons/modules/*.py

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

./scripts/addons_core/*.py

插件目录，用于捆绑插件。

./scripts/addons_core/modules/*.py

供 addons_core 使用的模块（找到后添加到 Python 的 sys.path 中）。

./scripts/modules/*.py

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

./scripts/startup/*.py

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

./scripts/startup/bl_app_templates_user/{APP_TEMPLATE_ID}

安装在用户目录中的应用模板。

./scripts/startup/bl_app_templates_system/{APP_TEMPLATE_ID}

自动从系统目录加载的应用模板。

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

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

./scripts/templates_py/*.py

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

./scripts/templates_osl/*.osl

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

./python

绑定的 Python 发行版。

位于系统目录中。

本地缓存目录

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

将使用以下路径：

  • 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\

临时目录

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

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

  • 用户设置（见文件路径）。

  • 环境变量（Windows 为 TEMP，其他平台为 TMP 或 TMP_DIR）。

  • /tmp/ 目录。