终端 > 设置文件

文件和文件夹位置

参考文档，说明 Warp 在 macOS、Windows 和 Linux 上存储配置、主题、标签页配置、设置、键位绑定、日志和其他文件的位置。

本参考文档列出了 Warp 在磁盘上读取或写入的每个目录和文件，按平台和 Warp 发布渠道进行组织。当您想要备份配置、直接编辑文件、调试丢失的设置或从其他 Shell（例如 WSL）符号链接 Warp 的配置时，可以使用它。

Warp 如何组织文件

Warp 将其文件分为三个类别，每个类别映射到的目录取决于您的平台。了解这些类别可以解释为什么两个看似相关的文件（例如主题和设置）在 Windows 和 Linux 上位于不同的根目录下，而在 macOS 上却位于同一个根目录下。

可移植用户数据 - 您希望复制到新机器的文件，例如主题、标签页配置、工作流和启动配置。
不可移植配置 - 仅限本地的配置，不适合漫游，例如 settings.toml 和 keybindings.yaml。
不可移植状态 - 特定于机器的状态，如日志、本地数据库和代码库上下文索引。

此外，一小部分跨平台文件始终位于每个平台的家目录下——目前包括 MCP 服务器配置和捆绑技能。Stable 和 Preview 版本共享同一个 ~/.warp/ 目录来存放这些文件（Preview 并不对 MCP 配置或技能使用 ~/.warp-preview/，因此与 Stable 并行安装 Preview 会共享相同的 MCP 服务器和技能）。其他发布渠道确实使用带有渠道后缀的目录——例如，~/.warp-oss/ 用于 OSS。这些文件位于家目录下，因此很容易从 Shell 配置、版本控制或其他工具中引用。

各平台的文件位置

下表涵盖了 Stable 渠道。有关 Preview 渠道的信息，请参阅预览版路径。

在 macOS 上，Stable 将所有由 Warp 创建的文件保存在 ~/.warp/ 下。Preview 对除跨平台 ~/.warp/ 共享部分之外的所有内容使用 ~/.warp-preview/。

可移植用户数据

主题 - ~/.warp/themes/
标签页配置 - ~/.warp/tab_configs/
默认标签页配置（内置，可由用户编辑） - ~/.warp/default_tab_configs/
工作流（本地） - ~/.warp/workflows/
启动配置 - ~/.warp/launch_configurations/

不可移植配置

设置文件 - ~/.warp/settings.toml
键位绑定 - ~/.warp/keybindings.yaml
用户首选项（旧版） - macOS defaults 域 dev.warp.Warp-Stable

不可移植状态

日志 - ~/Library/Logs/warp.log*
崩溃报告 - ~/Library/Logs/DiagnosticReports/ (Warp .ips 文件)
数据库、代码库上下文索引、MCP 日志 - ~/Library/Group Containers/2BBY89MBSN.dev.warp/Library/Application Support/dev.warp.Warp-Stable/

跨平台（始终在家目录下）

MCP 服务器配置 - ~/.warp/.mcp.json
捆绑技能 - ~/.warp/skills/
代理配置 - ~/.agents/

在 Windows 上，Warp 遵循 directories crate 使用的平台惯例，该惯例将用户数据拆分到 %APPDATA% (Roaming) 和 %LOCALAPPDATA% (Local) 中。主题和标签页配置是可移植的，位于 Roaming 中，而设置、日志和本地数据库是特定于机器的，位于 Local 中。因此存在两个独立的 data\ 目录——每个根目录下各一个——所以在定位文件时请检查完整路径。

可移植用户数据 (%APPDATA%\warp\Warp\data\, Roaming)

主题 - %APPDATA%\warp\Warp\data\themes\
标签页配置 - %APPDATA%\warp\Warp\data\tab_configs\
默认标签页配置（内置，可由用户编辑） - %APPDATA%\warp\Warp\data\default_tab_configs\
工作流（本地） - %APPDATA%\warp\Warp\data\workflows\
启动配置 - %APPDATA%\warp\Warp\data\launch_configurations\

不可移植配置 (%LOCALAPPDATA%\warp\Warp\config\)

设置文件 - %LOCALAPPDATA%\warp\Warp\config\settings.toml
键位绑定 - %LOCALAPPDATA%\warp\Warp\config\keybindings.yaml
用户首选项（旧版） - Windows 注册表键 HKCU:\Software\Warp.dev\Warp

不可移植状态 (%LOCALAPPDATA%\warp\Warp\data\)

日志 - %LOCALAPPDATA%\warp\Warp\data\logs\warp.log*
数据库、代码库上下文索引、MCP 日志 - %LOCALAPPDATA%\warp\Warp\data\ 下的其他子目录
缓存 - %LOCALAPPDATA%\warp\Warp\cache\

跨平台（始终在家目录下）

MCP 服务器配置 - %USERPROFILE%\.warp\.mcp.json
捆绑技能 - %USERPROFILE%\.warp\skills\
代理配置 - %USERPROFILE%\.agents\

在 Linux 上，Warp 遵循 XDG 基本目录规范。下面的每个路径都使用标准的 XDG 环境变量及其默认回退值。

可移植用户数据 (${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/)

主题 - ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/themes/
标签页配置 - ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/tab_configs/
默认标签页配置（内置，可由用户编辑） - ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/default_tab_configs/
工作流（本地） - ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/workflows/
启动配置 - ${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal/launch_configurations/

不可移植配置 (${XDG_CONFIG_HOME:-$HOME/.config}/warp-terminal/)

设置文件 - ${XDG_CONFIG_HOME:-$HOME/.config}/warp-terminal/settings.toml
键位绑定 - ${XDG_CONFIG_HOME:-$HOME/.config}/warp-terminal/keybindings.yaml

不可移植状态 (${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/)

日志 - ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/warp.log*
数据库、代码库上下文索引、MCP 日志 - ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal/ 下的其他文件
缓存 - ${XDG_CACHE_HOME:-$HOME/.cache}/warp-terminal/

跨平台（始终在家目录下）

MCP 服务器配置 - ~/.warp/.mcp.json
捆绑技能 - ~/.warp/skills/
代理配置 - ~/.agents/

预览版路径

预览版使用一组独立的目录，因此它永远不会覆盖您的 Stable 配置

macOS - 将上述 macOS 路径中的 ~/.warp/ 替换为 ~/.warp-preview/，并将 Warp-Stable 替换为 Warp-Preview。跨平台的 ~/.warp/ 共享部分（MCP 配置、技能）与 Stable 共享，不带有 -preview 后缀。
Windows - 将所有路径中的 \warp\Warp\ 替换为 \warp\WarpPreview\。日志变为 %LOCALAPPDATA%\warp\WarpPreview\data\logs\warp_preview.log*。注册表键为 HKCU:\Software\Warp.dev\WarpPreview（没有连字符 — Warp-Preview 是 macOS 捆绑包标识符，而不是 Windows 应用名称）。跨平台的 %USERPROFILE%\.warp\ 共享部分（MCP 配置、技能）与 Stable 共享。
Linux - 在每个 warp-terminal 目录后附加 -preview（例如 ~/.config/warp-terminal-preview/settings.toml）。日志变为 ${XDG_STATE_HOME:-$HOME/.local/state}/warp-terminal-preview/warp_preview.log*。跨平台的 ~/.warp/ 共享部分（MCP 配置、技能）与 Stable 共享。

从 WSL 符号链接 Warp 配置

如果您在 Windows 上运行 Warp 并且也使用 WSL，您可以将 Warp 配置共享给您的 WSL $HOME，以便在 WSL 内运行的工具可以读取相同的主题、标签页配置、设置、MCP 服务器和代理配置。WSL $HOME（通常是 /home/<wsl-user>/）与您的 Windows 配置文件（%USERPROFILE%，通常是 C:\Users\<Windows-user>\）是不同的 Linux 文件系统，因此 WSL 内的 ~/.warp/ 和 ~/.agents/ 不是自动与 Windows 端同名的目录相同的——您想要共享的每个 Warp 目录都需要自己的符号链接，指向 Windows 路径。

您的 WSL Linux 用户名（$USER）通常也与您的 Windows 账户名不同，因此不要假设 /mnt/c/Users/$USER 可以解析为您的 Windows 配置文件。通过 cmd.exe 解析 %USERPROFILE% 并改用 wslpath 转换它，然后从 WSL Shell 运行符号链接

# Resolve the Windows %USERPROFILE% (e.g. C:\Users\Alex) into a WSL path
# (e.g. /mnt/c/Users/Alex). Avoids hard-coding the Windows username or
# assuming it matches your WSL $USER.
WIN_HOME=$(wslpath "$(cmd.exe /C 'echo %USERPROFILE%' 2>/dev/null | tr -d '\r')")

# Portable data: themes, tab configs, workflows, launch configurations (Roaming AppData).
ln -s "$WIN_HOME/AppData/Roaming/warp/Warp/data" ~/.warp-windows-data

# Local config: settings.toml, keybindings.yaml (Local AppData).
ln -s "$WIN_HOME/AppData/Local/warp/Warp/config" ~/.warp-windows-config

# Cross-platform carve-outs that live under Windows %USERPROFILE%:
# MCP server config and bundled skills (Windows-side ~/.warp).
ln -s "$WIN_HOME/.warp" ~/.warp

# Agent config (Windows-side ~/.agents).
ln -s "$WIN_HOME/.agents" ~/.agents

如果 ~/.warp 或 ~/.agents 已存在于 WSL 中，请先删除或备份它们——否则 ln 将在现有目录内创建链接，而不是替换它。如果您更喜欢硬编码 Windows 用户名而不是使用 wslpath，请从 WSL 使用 cmd.exe /C 'echo %USERNAME%' 2>/dev/null | tr -d '\r' 查找它，并将上面的 $WIN_HOME 替换为 /mnt/c/Users/<your-windows-username>。

设置文件 - settings.toml 的格式、热重载行为和常见示例。
所有设置参考 - settings.toml 中可用的每个设置，按部分组织。
键盘快捷键 - 如何查看和重新映射快捷键，包括 keybindings.yaml 文件。
标签页配置 - tab_configs/ 中标签页配置文件的 TOML 格式和模式。
自定义主题 - themes/ 中主题的 YAML 格式和图像规范。
卸载 Warp - 卸载时删除所有这些文件的命令。

文件和文件夹位置

Warp 如何组织文件

各平台的文件位置

预览版路径

从 WSL 符号链接 Warp 配置

相关页面