Blender目录布局

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

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

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

对于系统级安装, SYSTEMUSER 文件夹都是必需的。

对于本地解压的Blender发行版,这些用户配置数据和运行时数据均位于相同的子文件夹下面,允许Blender的多个版本共存而且不会有冲突,可以忽略 USERSYSTEM 文件。

平台相关路径

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

Note

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

Linux

LOCAL:
  1. ./2.80/
USER:
  1. $HOME/.config/blender/2.80/
SYSTEM:
  1. /usr/share/blender/2.80/

Note

如果设置了 $XDG_CONFIG_HOMEUSER 路径会使用该设置:

  1. $XDG_CONFIG_HOME/blender/2.80/

macOS

LOCAL:
  1. ./2.80/
USER:
  1. /Users/$USER/Library/Application Support/Blender/2.80/
SYSTEM:
  1. /Library/Application Support/Blender/2.80/

Note

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

  1. ./Blender.app/Contents/Resources/2.80/

Windows

LOCAL:
  1. .\2.80\
USER:
  1. %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.80\
SYSTEM:
  1. %USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\2.80\

路径布局

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

比方说, ./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/ 目录。