Windows Terminal 启动目录设置：3 种方式让终端自动打开项目路径

Windows Terminal 启动目录设置：3 种方式让终端自动打开项目路径

【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal

每天打开终端，第一件事都是敲cd切到项目目录。重复了无数次之后，我改了一行startingDirectory配置，这个动作就永远省掉了。下面覆盖三个场景：固定项目、多项目入口、临时切目录。

✅ 给指定配置文件固定启动目录 ✅ 每个项目建一个独立入口 ✅ 用命令行参数临时指定目录 ✅ WSL 路径的处理

第一步：最小改动，先跑起来

只改一个字段，30 秒生效。配置文件是settings.json，两种打开方式：

• 按Ctrl+,打开设置界面，进入某个配置文件的"启动目录"一项，直接填路径
• 嫌麻烦就编辑 JSON 原文，位置在%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

找到profiles.list里你要改的那个配置，加一行：

{ "profiles": { "list": [ { "guid": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}", "name": "Windows PowerShell", "startingDirectory": "D:\\Projects\\MyApp", "..." : "..." } ] } }

startingDirectory就是启动目录本身。注意 JSON 里反斜杠要写成双份\\，或者直接用正斜杠。

验证很简单：关掉终端重开。新建 PowerShell 标签页时，你应该已经站在D:\Projects\MyApp里了，不需要敲任何命令。

第二步：按你的实际场景来

同时维护几个项目的人

每个项目一个入口，开新标签页时点哪个配置，就落在哪个目录。做法是把 PowerShell 配置复制几份，改name和startingDirectory：

[ { "name": "PowerShell - MyApp", "commandline": "powershell.exe", "startingDirectory": "D:\\Projects\\MyApp" }, { "name": "PowerShell - Website", "commandline": "powershell.exe", "startingDirectory": "D:\\Projects\\Website" } ]

保存后，新建标签页的菜单里就有这两个入口，各进各的目录。


如果路径前缀都一样，别写死绝对路径。在系统环境变量里加一个%MY_PROJECTS%，配置里写%MY_PROJECTS%\\MyApp就行。Windows Terminal 会自动展开环境变量，换个机器只要变量还在，配置不用动。

临时切个目录跑个脚本

一次性任务不用改配置。wt命令带-d参数即可：

wt -d "D:\Temp\TestProject" wt -p "Command Prompt" -d "C:\Tools"

第一条用默认配置文件、指定目录打开；第二条先用-p选配置文件，再指定目录。参数定义可参考仓库里的doc/specs/#607 - Commandline Arguments for the Windows Terminal.md。

适用边界：偶尔用一次，选它；天天用的目录，写进配置更稳，不然你迟早忘记带-d。

用 WSL 的人

WSL 配置（source为Windows.Terminal.Wsl）里，startingDirectory可以写 Linux 风格路径：

{ "name": "Ubuntu", "source": "Windows.Terminal.Wsl", "startingDirectory": "~" }

~会落在 WSL 的用户主目录。想固定到某个项目，写成/home/username/projects这类路径即可。

配置项速查

字段含义拿不准时，可以对照仓库里的doc/cascadia/profiles.schema.json，每个配置项都有说明。

踩坑记录

⚠️ 现象：配置改完，开终端直接报错，标签页里提示无法启动会话。 原因：startingDirectory写的路径不存在，或者拼错了。现在版本不会再悄悄退回用户目录救场，直接失败给你看。 处理：先确认路径真实存在，再检查双反斜杠有没有漏写。

⚠️ 现象：路径带空格，比如C:\Program Files，你顺手加了一对引号，结果配置不生效。 原因：引号被当成了路径字符串的一部分，解析出来的路径多了两个引号字符，自然找不到。 处理：直接写路径就行，JSON 解析器自己会处理空格，不需要额外加引号。

⚠️ 现象：wt -d明明能切目录，为什么我平时打开还是老目录？ 原因：-d只对那一条命令行生效，没带-d的启动就是默认配置，两者互不影响。 处理：这是设计如此。长期需求写进 profile，临时需求才用-d。

到这里，每次开终端的cd就可以省掉了。你还有什么启动目录的用法或坑，欢迎留言聊聊。

【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal