windows terminal 的 settings.json 是纯文本 json 文件,导出即复制默认路径 %localappdata%packagesmicrosoft.windowsterminal_8wekyb3d8bbwelocalstatesettings.json 下的文件,导入即覆盖该路径文件并重启终端;推荐用 vs code 编辑以避免编码错误,跨设备同步需注意 wsl 路径适配。
windows terminal 的配置文件(settings.json)是纯文本 json 文件,不依赖数据库或注册表,因此导入导出非常直接——本质就是复制和替换这个文件。
导出当前完整配置文件
导出操作其实就是找到并备份当前生效的 settings.json 文件:
- 该文件默认位于:
%LOCALAPPDATA%PackagesMicrosoft.WindowsTerminal_8wekyb3d8bbweLocalStatesettings.json - 在文件资源管理器地址栏中粘贴上述路径,回车即可直达(若提示“找不到”,请确认已安装 Windows Terminal 并至少启动过一次)
- 直接复制整个
settings.json文件,粘贴到桌面或云盘等安全位置,即完成导出 - 建议同时备份同目录下的
profiles.json(旧版遗留)或themes子目录(如有自定义配色方案),但新版通常只用一个settings.json
导入配置文件(覆盖或迁移)
导入即用新配置替换本地文件,重启终端立即生效:
- 关闭所有 Windows Terminal 窗口(包括后台进程,可任务管理器中结束
windowsterminal.exe) - 将备份好的
settings.json文件,完整覆盖到上述默认路径中 - 重新打开 Windows Terminal,所有配置(主题、字体、快捷键、profile 列表、背景图等)都会恢复
- 如遇格式错误导致终端无法启动,可按住 Alt 键点击设置按钮,让系统自动生成一份默认配置,再手动合并修改
通过设置界面导出/同步更简单的方式
虽然没有“一键导出按钮”,但设置 UI 提供了便捷入口:
- 打开 Terminal → 点击下拉箭头 → “设置” → 左下角有“打开 JSON 文件”链接,直接跳转到
settings.json所在目录 - 编辑保存后,Terminal 会自动热重载大部分设置(部分如快捷键需重启生效)
- 想跨设备同步?可将该文件放入 OneDrive 或 GitHub,配合符号链接(symlink)或脚本自动部署,实现多机配置一致
注意事项
几个容易踩坑的关键点:
- 不要用记事本直接编辑:推荐 VS Code、Notepad++ 等支持 UTF-8 BOM 清除和 JSON 校验的编辑器,避免编码错误导致解析失败
-
GUID 唯一性无需担心:每个 profile 的
guid是自动生成的标识符,导出再导入时即使 GUID 不变也完全正常;不同机器间 GUID 冲突不会影响功能 -
WSL 路径需适配本地环境:若配置中含
"\\wsl$\Ubuntu\home\user"这类路径,迁移到另一台电脑时,请确认 WSL 发行版名称和用户名是否一致,否则需手动修正 -
管理员权限不是必须的:只要对
%LOCALAPPDATA%目录有写入权限(普通用户默认就有),无需以管理员身份运行终端来修改配置











