Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Godot 项目中的文件路径
本页面会讲解 Godot 项目中文件路径的工作原理。你会学到如何在项目中使用 res:// 和 user:// 标记来访问路径，以及 Godot 会在你的以及用户系统上的哪些位置存储项目和编辑器文件。
路径分隔符
为了让支持跨平台更方便，Godot 使用 UNIX 风格的路径分隔符（正斜杠 /）。在所有平台上都可以使用，包括 Windows。
在 Godot 里写的不是类似 C:\Projects\Game 的路径，而应该写 C:/Projects/Game。
有些路径相关的方法也支持 Windows 风格的路径分隔符（反斜杠\），不过需要写两个（\\），因为 \ 一般是用来进行字符转义的，有特殊含义。
这样就能够处理其他 Windows 程序所返回的路径了。我们仍然建议在你自己的代码里只使用正斜杠，这样才能确保一切都能正常工作。
小技巧
The String class offers over a dozen methods to work with strings that represent file paths:
访问项目文件夹中的文件（res://）
只要文件夹中存在名叫 project.godot 的文本文件，即便是空文件，Godot 也会认为这个文件夹中包含了一个项目。包含这个文件的文件夹是你的项目的根文件夹。
相对于这个文件夹的任何文件，都可以通过以 res:// 开头的路径访问，这个前缀代表“资源”（resource）。例如，在代码中，你可以通过 res://character.png 来访问位于项目根文件夹的 character.png 图片。
访问持久化用户数据（user://）
要存储持久化数据文件，比如玩家的存档、设置等，你会想要使用 user:// 作为路径前缀，而不是 res://。这是因为游戏运行时，项目的文件系统很可能是只读的。
user:// 前缀指向的是用户设备上的其他目录。与 res:// 不同，即便在导出后的项目中，user:// 指向的这个目录也会自动创建并且保证可写。
user:// 文件夹的位置由“项目设置”中的配置决定：
默认情况下，
user://文件夹是在编辑器数据路径中创建的app_userdata/[项目名称]文件夹。使用这一默认值的目的是让原型和测试项目能够在 Godot 的数据文件夹中达到自包含。如果在项目设置中启用了 application/config/use_custom_user_dir，则会在 Godot 编辑器数据路径的旁边创建
user://文件夹，即在应用程序数据的标准位置。默认情况下，文件夹名称是从项目名称推导出来的，但可以使用 application/config/custom_user_dir_name 进行进一步的自定义。这个路径可以包含路径分隔符，那么比如你就可以把给定工作室的项目都分组到
工作室名称/游戏名称这样的目录结构之下。
在桌面平台上，user:// 的实际目录路径为：
类型 |
位置 |
|---|---|
默认 |
Windows：
%APPDATA%\Godot\app_userdata\[项目名称]macOS：
~/Library/Application Support/Godot/app_userdata/[项目名称]Linux：
~/.local/share/godot/app_userdata/[项目名称] |
自定义目录 |
Windows：
%APPDATA%\[项目名称]macOS：
~/Library/Application Support/Godot/[项目名称]Linux：
~/.local/share/godot/[项目名称] |
自定义目录及名称 |
Windows：
%APPDATA%\[自定义目录名称]macOS：
~/Library/Application Support/[自定义目录名称]Linux：
~/.local/share/[自定义目录名称] |
[项目名称] 基于的是项目设置中定义的应用名称，不过你可以使用特性标签来为不同平台单独进行覆盖。
在移动平台上，这个路径是与项目相关的，每个项目都不一样，并且出于安全原因无法被其他应用程序访问。
在 HTML5 导出中，user:// 会指向保存在设备的虚拟文件系统，这个文件系统使用 IndexedDB 实现。（仍然可以通过 JavaScriptBridge 与主文件系统交互。）
File logging
By default, Godot writes log files in user://logs/godot.log on desktop
platforms. You can change this location by modifying the
debug/file_logging/log_path project setting. Logs are rotated to keep older
files available for inspection. Each session creates a new log file, with the
old file renamed to contain the date at which it was rotated. Up to 5 log files
are kept by default, which can be adjusted using the
debug/file_logging/max_log_files project setting.
File logging can also be disabled completely using the
debug/file_logging/enable_file_logging project setting.
When the project crashes, crash logs are written to the same file as the log file. The crash log will only contain a usable backtrace if the binary that was run contains debugging symbols, or if it can find a debug symbols file that matches the binary. Official binaries don't provide debugging symbols, so this requires a custom build to work. See Debugging symbols. for guidance on compiling binaries with debugging symbols enabled.
备注
Log files for print statements are updated when standard output is flushed by the engine. Standard output is flushed on every print in debug builds only. In projects that are exported in release mode, standard output is only flushed when the project exits or crashes to improve performance, especially if the project is often printing text to standard output.
On the other hand, the standard error stream (used by printerr, push_error and push_warning) is always flushed on every print, even in projects exported in release mode.
For some use cases like dedicated servers, it can be preferred to have release
builds always flush stdout on print, so that logging services like journald can
collect logs while the process is running. This can be done by enabling
application/run/flush_stdout_on_print in the Project Settings.
将路径转换为绝对路径或“本地”路径
你可以使用 ProjectSettings.globalize_path() 将类似 res://path/to/file.txt 的本地路径转换为操作系统的绝对路径。例如，可以使用 ProjectSettings.globalize_path() 在操作系统的文件管理器中通过 OS.shell_open() 打开“本地”路径，因为这个函数只接受原生操作系统路径。
要将操作系统绝对路径转换为以 res:// 或 user:// 开头的“本地”路径，请使用 ProjectSettings.localize_path()。只对指向项目根目录或者 user:// 文件夹中的文件或文件夹有效。
编辑器数据路径
根据平台的不同，编辑器会使用不同的路径来存储编辑器数据、编辑器设置、缓存。默认情况下，这些路径是：
类型 |
位置 |
|---|---|
编辑器数据 |
Windows：
%APPDATA%\Godot\macOS：
~/Library/Application Support/Godot/Linux：
~/.local/share/godot/ |
编辑器设置 |
Windows：
%APPDATA%\Godot\macOS：
~/Library/Application Support/Godot/Linux：
~/.config/godot/ |
缓存 |
Windows：
%TEMP%\Godot\macOS：
~/Library/Caches/Godot/Linux：
~/.cache/godot/ |
编辑器数据包含导出模板和具体项目数据。
编辑器设置包含主编辑器设置的配置，以及各种针对用户的自定义信息（编辑器布局、功能配置、脚本模板等）。
缓存包含编辑器生成的数据，或者临时存储的数据。当 Godot 关闭时可以放心地移除。
Godot complies with the XDG Base Directory Specification
on Linux/*BSD. You can override the XDG_DATA_HOME, XDG_CONFIG_HOME and
XDG_CACHE_HOME environment variables to change the editor and project data
paths.
备注
如果你使用的是 Flatpak 打包的 Godot，编辑器数据路径将位于 ~/.var/app/org.godotengine.godot/ 的子文件夹中。
自包含模式
如果你在编辑器二进制文件所在的目录下创建了名为 ._sc_ 或 _sc_ 的文件（macOS 编辑器 .app 捆绑包则是在 MacOS/Contents/ 下），Godot 就会开启自包含模式。这种模式下，Godot 会将所有编辑器数据、设置、缓存都写入一个与编辑器二进制文件位于同一目录中的名为 editor_data/ 的目录。你可以用它来创建便携安装的编辑器。
Steam 版本的 Godot 默认使用自包含模式。
备注
导出后的项目目前不支持自包含模式。要对相对于可执行文件路径的文件进行读写，请使用 OS.get_executable_path()。注意，只有可执行文件位于可写的位置时，才能够对可执行文件路径上的文件进行写操作（即不在 Program Files 或者其他普通用户只读的目录中）。