Windows Terminal配置文件图标设置PowerShell脚本故障排查

问题诊断 #

你的代码存在两个关键问题导致无法正确设置图标：

1. 路径字符串未用引号包裹，PowerShell无法正确解析为字符串值
2. Set-Content 默认编码可能与Windows Terminal的JSON文件要求不匹配，导致写入后配置失效

修正后的代码 #

# 定义路径变量（确保$WSLname和$InstallPath已正确初始化）
$settingsPath = "$env:localappdata\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"

# 读取并解析JSON配置
$settings = Get-Content $settingsPath -Raw | ConvertFrom-Json

# 查找并修改目标配置项
$targetProfile = $settings.profiles.list | Where-Object { $_.name -eq $WSLname }
if ($targetProfile) {
    # 设置图标路径（用引号包裹确保字符串正确）
    $targetProfile.icon = "$InstallPath\fedora.ico"
} else {
    Write-Warning "未找到名称为'$WSLname'的终端配置文件"
}

# 写入修改后的配置，指定UTF-8编码避免乱码
$settings | ConvertTo-Json -Depth 32 | Set-Content $settingsPath -Encoding UTF8

关键改进点 #

• 路径字符串处理：将 $InstallPath\fedora.ico 改为 "$InstallPath\fedora.ico"，确保PowerShell将其识别为字符串类型而非路径表达式
• 显式查找配置项：用 Where-Object 直接定位目标配置，更直观且便于后续判断是否存在
• UTF-8编码写入：添加 -Encoding UTF8 参数，保证输出文件编码与Windows Terminal要求一致，避免配置文件读取失败
• 存在性检查：增加分支判断，当目标配置不存在时给出明确警告

注意事项 #

1. 确保脚本运行时Windows Terminal已完全关闭（如你补充说明，需在终端重启后运行）
2. 确认 $InstallPath 是绝对路径，相对路径可能导致终端无法找到图标文件
3. 图标文件格式需为Windows Terminal支持的格式（如ICO、PNG）

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