Blender 目录布局#
本页记录了 Blender 使用的不同目录。
这有助于故障排除、自动化和定制。
用户目录#
用户目录存储偏好设置、启动文件、已安装的扩展、预设等。默认情况下,这些目录使用每个操作系统的标准配置文件夹。
Linux#
$HOME/.config/blender/4.2/
如果设置了 $XDG_CONFIG_HOME
环境变量:
$XDG_CONFIG_HOME/blender/4.2/
macOS#
/Users/$USER/Library/Application Support/Blender/4.2/
Windows#
%USERPROFILE%\AppData\Roaming\Blender Foundation\Blender\4.2\
便携安装#
在便携式硬盘上运行 Blender 时,可以将配置文件保存在同一硬盘上,以便随身携带。
要启用此功能,请在以下位置创建名为 portable
的文件夹:
Windows:在已解压文件夹中的 Blender 可执行文件旁
Linux:在已解压文件夹中的 Blender 可执行文件旁
macOS:应用程序捆绑包内的
Blender.app/Contents/Resources
该文件夹将存储偏好设置、启动文件、已安装的扩展和预设。
环境变量#
可以将 BLENDER_USER_RESOURCES
环境变量设置为自定义目录,以替换默认用户目录。
系统目录#
系统目录存储 Blender 附带的文件,这些文件是 Blender 正常运行所必需的。其中包括脚本、预设、基本资产等。
Linux#
从 blender.org 下载的文件:
./4.2/
Linux 发行版软件包:
/usr/share/blender/4.2/
macOS#
./Blender.app/Contents/Resources/4.2/
Windows#
从 blender.org 下载的 Zip 文件:
./4.2/
从 blender.org 下载的安装包:
%ProgramFiles%\Blender Foundation\Blender\4.2\
Microsoft 商店安装:
%ProgramFiles%\WindowsApps\BlenderFoundation.Blender<HASH>\Blender\4.2\
环境变量#
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
可以从
访问的示例脚本。./scripts/templates_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/
目录。