Windows Terminal 启动目录怎么改startingDirectory 配置与 wt -d 参数实操【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal每次打开终端第一件事都是敲cd 项目目录多开几个标签页就得重复好几遍。Windows Terminal 的每个 Profile 都有一个startingDirectory字段给不同终端分别自定义启动目录之后新标签页一打开就停在项目里省掉那行cd。本文按固定项目、多项目切换、临时改一次、WSL四种场景演示修改方法照着做 5 分钟就能配好。原理速览startingDirectory 存在哪所有配置都存在一份 JSON 文件里%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json在终端内按Ctrl,可打开图形界面图形界面和 JSON 改的是同一份文件。startingDirectory是 Profile 级字段决定该 Profile 拉起的 shell 进程初始工作目录不填就落在你的用户目录。JSON 里路径要写双反斜杠\\或正斜杠/这条规则后面反复用到。字段定义可查 官方配置文档。固定项目常驻GUI 与 JSON 两个入口都改得到场景 A只有一个主工作目录希望每次打开都直接停在那。入口一图形界面3 步Ctrl,打开设置左侧 Profiles 选中目标 profile如 Windows PowerShell。找到 Starting directory 输入框填入项目路径。点 Save新开一个标签页确认提示符停在项目里。入口二手动改 JSON。settings.json 里找到对应 profile加一行{ name: Windows PowerShell, startingDirectory: D:\\Projects\\MyApp }注意 JSON 内路径写D:\\Projects双反斜杠或直接写D:/Projects/正斜杠。改完保存WT 会自动重载配置。GUI 与 JSON 改的是同一个字段建议只在 GUI 操作需要批量调整时再动 JSON别两边同时开着改。多项目动态切换用 %变量% 让路径跟随环境场景 B项目目录经常搬家、或换台机器就不想重配一遍。startingDirectory支持%变量%形式的环境变量WT 会先展开再启动 shell几种常见写法startingDirectory: %USERPROFILE%\\Documents\\Projects startingDirectory: %WORK%\\site-a startingDirectory: %WORK%\\site-b前一行指向你的用户目录下的固定子文件夹后两行的%WORK%是你自己在系统属性 → 环境变量里定义的自定义变量指向项目根目录。好处是项目整体挪盘时只改一处变量所有 profile 跟着变。新建的系统变量需要新进程才能读到定义完后重新登录或至少重开终端旧进程拿到的还是空值。临时改一次wt -d 命令行参数场景 C只想这一次从别的目录启动不想动任何配置。在任意终端包括 CMD、PowerShell执行wt -d D:\Temp\TestProject-d即--startingDirectory只影响这条命令拉起的标签页。可组合-p指定 profilewt -p Command Prompt -d C:\Data\Logs也可用在wt new-tab子命令上。参数长形式是驼峰的--startingDirectory不是--starting-directory路径含空格就整体加引号。更多用法见 命令行参数文档。进阶WSL 路径的两种写法和按项目拆 ProfileWSL 的路径写法特殊两种都支持。推荐直接在 WSL 的 Profile 里填~由发行版自己解析成当前用户 homestartingDirectory: ~~只在source为Windows.Terminal.Wsl的 profile 里有意义给普通 Windows profile 填了不会被展开。也可以写 Windows 侧的 UNC 形式指进发行版内部startingDirectory: \\\\wsl$\\Ubuntu\\home\\username\\projects前提是该发行版至少启动过一次\\wsl$\下才有对应目录。项目多到标签页命名都分不清时按项目拆独立 Profile设置里 Profiles → Add new → Duplicate 一份现有 profile。改name如PowerShell - MyApp。填各自的startingDirectory。加一个icon字段如icon: D:\\Projects\\MyApp\\app.ico标签页下拉里就能一眼认出来。避坑清单三个高频问题症状路径带空格启动目录不生效。原因JSON 值两端又加了一层引号。startingDirectory: \C:\\Program Files\\App\会被当成字面引号目录自然找不到。修复确认值里没有多余的引号或单引号正确写法就是startingDirectory: C:\\Program Files\\App。症状WSL 目录不可达报无法访问指定目录。原因发行版没启动过\\wsl$\下还没有对应目录或路径里的用户名段拼错。修复先在资源管理器地址栏访问\\wsl$\确认发行版目录存在再逐段核对 home 路径拿不准就直接改用~。症状改完 settings.json 完全不生效。排查三步① 确认编辑的是%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState下这份 settings.json别改到 %AppData% 里那份② 关闭所有 WT 窗口后重新打开③ 用wt -d直接指向该路径验证目录本身是否可达。怎么选固定项目startingDirectory填死路径多项目切换%变量%引用环境变量临时一次wt -d参数WSL~或 UNC 路径现在就做一件事打开 WT 按Ctrl,进设置把主力 Profile 的 Starting directory 填成你今天最常打开的那个项目路径。【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Windows Terminal 启动目录怎么改：startingDirectory 配置与 wt -d 参数实操
Windows Terminal 启动目录怎么改startingDirectory 配置与 wt -d 参数实操【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal每次打开终端第一件事都是敲cd 项目目录多开几个标签页就得重复好几遍。Windows Terminal 的每个 Profile 都有一个startingDirectory字段给不同终端分别自定义启动目录之后新标签页一打开就停在项目里省掉那行cd。本文按固定项目、多项目切换、临时改一次、WSL四种场景演示修改方法照着做 5 分钟就能配好。原理速览startingDirectory 存在哪所有配置都存在一份 JSON 文件里%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json在终端内按Ctrl,可打开图形界面图形界面和 JSON 改的是同一份文件。startingDirectory是 Profile 级字段决定该 Profile 拉起的 shell 进程初始工作目录不填就落在你的用户目录。JSON 里路径要写双反斜杠\\或正斜杠/这条规则后面反复用到。字段定义可查 官方配置文档。固定项目常驻GUI 与 JSON 两个入口都改得到场景 A只有一个主工作目录希望每次打开都直接停在那。入口一图形界面3 步Ctrl,打开设置左侧 Profiles 选中目标 profile如 Windows PowerShell。找到 Starting directory 输入框填入项目路径。点 Save新开一个标签页确认提示符停在项目里。入口二手动改 JSON。settings.json 里找到对应 profile加一行{ name: Windows PowerShell, startingDirectory: D:\\Projects\\MyApp }注意 JSON 内路径写D:\\Projects双反斜杠或直接写D:/Projects/正斜杠。改完保存WT 会自动重载配置。GUI 与 JSON 改的是同一个字段建议只在 GUI 操作需要批量调整时再动 JSON别两边同时开着改。多项目动态切换用 %变量% 让路径跟随环境场景 B项目目录经常搬家、或换台机器就不想重配一遍。startingDirectory支持%变量%形式的环境变量WT 会先展开再启动 shell几种常见写法startingDirectory: %USERPROFILE%\\Documents\\Projects startingDirectory: %WORK%\\site-a startingDirectory: %WORK%\\site-b前一行指向你的用户目录下的固定子文件夹后两行的%WORK%是你自己在系统属性 → 环境变量里定义的自定义变量指向项目根目录。好处是项目整体挪盘时只改一处变量所有 profile 跟着变。新建的系统变量需要新进程才能读到定义完后重新登录或至少重开终端旧进程拿到的还是空值。临时改一次wt -d 命令行参数场景 C只想这一次从别的目录启动不想动任何配置。在任意终端包括 CMD、PowerShell执行wt -d D:\Temp\TestProject-d即--startingDirectory只影响这条命令拉起的标签页。可组合-p指定 profilewt -p Command Prompt -d C:\Data\Logs也可用在wt new-tab子命令上。参数长形式是驼峰的--startingDirectory不是--starting-directory路径含空格就整体加引号。更多用法见 命令行参数文档。进阶WSL 路径的两种写法和按项目拆 ProfileWSL 的路径写法特殊两种都支持。推荐直接在 WSL 的 Profile 里填~由发行版自己解析成当前用户 homestartingDirectory: ~~只在source为Windows.Terminal.Wsl的 profile 里有意义给普通 Windows profile 填了不会被展开。也可以写 Windows 侧的 UNC 形式指进发行版内部startingDirectory: \\\\wsl$\\Ubuntu\\home\\username\\projects前提是该发行版至少启动过一次\\wsl$\下才有对应目录。项目多到标签页命名都分不清时按项目拆独立 Profile设置里 Profiles → Add new → Duplicate 一份现有 profile。改name如PowerShell - MyApp。填各自的startingDirectory。加一个icon字段如icon: D:\\Projects\\MyApp\\app.ico标签页下拉里就能一眼认出来。避坑清单三个高频问题症状路径带空格启动目录不生效。原因JSON 值两端又加了一层引号。startingDirectory: \C:\\Program Files\\App\会被当成字面引号目录自然找不到。修复确认值里没有多余的引号或单引号正确写法就是startingDirectory: C:\\Program Files\\App。症状WSL 目录不可达报无法访问指定目录。原因发行版没启动过\\wsl$\下还没有对应目录或路径里的用户名段拼错。修复先在资源管理器地址栏访问\\wsl$\确认发行版目录存在再逐段核对 home 路径拿不准就直接改用~。症状改完 settings.json 完全不生效。排查三步① 确认编辑的是%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState下这份 settings.json别改到 %AppData% 里那份② 关闭所有 WT 窗口后重新打开③ 用wt -d直接指向该路径验证目录本身是否可达。怎么选固定项目startingDirectory填死路径多项目切换%变量%引用环境变量临时一次wt -d参数WSL~或 UNC 路径现在就做一件事打开 WT 按Ctrl,进设置把主力 Profile 的 Starting directory 填成你今天最常打开的那个项目路径。【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考