如何通过PowerShell脚本在Windows Terminal中创建自定义配置文件？

目前Windows Terminal没有官方提供用于修改配置的API或命令行工具，所以最可靠的自动化方式就是直接编辑它的settings.json配置文件。不过你可以通过PowerShell安全地完成这个操作，避免手动编辑可能出现的格式错误。

步骤1：定位配置文件路径 #

Windows Terminal的默认配置文件路径为：

$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

如果你使用的是预览版，路径中的包名会改为Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe。也可以通过Terminal界面的「设置」→「打开JSON」来确认当前配置文件的位置。

步骤2：PowerShell脚本示例（添加自定义配置） #

以下脚本会读取现有配置，添加一个自定义PowerShell配置文件，然后写回配置文件：

# 配置文件路径（根据你的Terminal版本调整）
$settingsPath = Join-Path $env:LOCALAPPDATA "Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"

# 读取现有配置
$settings = Get-Content $settingsPath -Raw | ConvertFrom-Json

# 定义新的配置文件
$newProfile = [PSCustomObject]@{
    guid = "{$([guid]::NewGuid().ToString())}" # 生成唯一GUID
    name = "自定义PowerShell"
    commandline = "pwsh.exe -NoLogo"
    hidden = $false
    icon = "C:\Icons\powershell.ico" # 可选：设置自定义图标路径
    colorScheme = "One Dark" # 可选：指定已存在的配色方案名称
    startingDirectory = "C:\Users\YourUsername" # 可选：设置默认启动目录
}

# 检查是否已有同名配置，避免重复添加
if (-not ($settings.profiles.list | Where-Object { $_.name -eq $newProfile.name })) {
    $settings.profiles.list += $newProfile
    # 将修改后的配置写回文件（-Depth参数确保嵌套结构完整）
    $settings | ConvertTo-Json -Depth 10 | Set-Content $settingsPath -Encoding UTF8
    Write-Host "自定义配置文件已成功添加"
} else {
    Write-Host "同名配置文件已存在，无需重复添加"
}

注意事项 #

• 修改前建议备份settings.json文件，防止配置丢失。
• 如果Windows Terminal正在运行，修改后的配置需要重启Terminal才能生效。
• 配色方案和图标路径需要确保系统能正常访问，否则会使用默认值。

内容的提问来源于stack exchange，提问作者Craig