Blender 目录布局

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

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

用户目录

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

Linux

  1. $HOME/.config/blender/4.3/

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

  1. $XDG_CONFIG_HOME/blender/4.3/

macOS

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

Windows

  1. %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 下载的文件：

  1. ./4.3/

Linux 发行版软件包：

  1. /usr/share/blender/4.3/

macOS

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

Windows

从 blender.org 下载的 Zip 文件：

  1. ./4.3/

从 blender.org 下载的安装包：

  1. %ProgramFiles%\Blender Foundation\Blender\4.3\

Microsoft 商店安装：

  1. %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/ 目录。