PowerShell 终端超链接快速上手指南：让输出的 URL 能直接点击-编程实验室

PowerShell 终端超链接快速上手指南：让输出的 URL 能直接点击

【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell

PowerShell 内置的 $PSStyle.FormatHyperlink() 能把命令输出里的 URL 和路径变成可点击链接。本文带你 5 分钟跑通：查版本、最小示例、写进自己的脚本，还能把链接塞进表格和报告里。

场景切入：复制粘贴太麻烦了

你在终端里跑了一条命令，输出一排依赖包的下载地址。想打开看看，只能鼠标选中、Ctrl+C、切浏览器、Ctrl+V——一行链接就要点四次鼠标。如果输出的是 20 行链接呢？

这正是终端超链接要解决的：链接直接可点，光标移上去还能看到完整 URL。

核心功能速览

本质就一行代码：$PSStyle.FormatHyperlink("文本", 目标链接) 会返回一段 ANSI OSC 8 转义序列，现代终端（Windows Terminal、iTerm2、VS Code 终端等）渲染后就是可点击的链接。

# 生成一段带链接的字符串 $PSStyle.FormatHyperlink("PowerShell 文档", [uri]"https://learn.microsoft.com/powershell")

运行后终端里显示的文本会变成蓝色可点击样式，单击直达目标页面。

注：该能力自 7.2 起内置，旧版终端（如部分 Linux 老版 tmux）会原样显示转义字符，属正常现象。

PowerShell 终端窗口中查看版本信息的实际效果

分步实操

5.1 检查你的 PowerShell 是否带这个功能

先确认 $PSStyle 变量里有没有 FormatHyperlink 方法：

# 一行判断当前环境是否支持 bool

预期输出 True。如果是 False，说明你用的是 Windows PowerShell 5.1（它没有 $PSStyle），需要升级到 PowerShell 7.2+。

5.2 最小可运行示例

两条命令就能跑通，先看效果再谈用法：

# 打印一个可点击链接 Write-Host $PSStyle.FormatHyperlink("点我访问 PowerShell", [uri]"https://aka.ms/powershell")

预期：终端出现"点我访问 PowerShell"字样，鼠标悬停变指针，点击后浏览器打开对应页面。

5.3 把链接写进自己的报告脚本

下面这个小函数会把构建日志里附带的资源地址都变成可点击的，直接复制到你的脚本里即可：

function Show-ReleaseLinks { Write-Host "本次构建的参考资源：" # 每行链接都可点击 Write-Host $PSStyle.FormatHyperlink(" - 变更日志", [uri]"https://aka.ms/powershell") Write-Host $PSStyle.FormatHyperlink(" - 常见问题", [uri]"https://aka.ms/powershell") } Show-ReleaseLinks

进阶玩法

在表格里塞进可点击链接

Format-Table 的列表达式里直接嵌入，输出表格每行都有一个入口：

$items = @( [pscustomobject]@{Name="A"; Url="https://aka.ms/powershell"} [pscustomobject]@{Name="B"; Url="https://aka.ms/powershell"} ) $items | Format-Table Name, @{L="链接";E={$PSStyle.FormatHyperlink("打开",[uri]$_.Url)}}

写个通用包装函数，全脚本复用

把"文本 + 链接"的拼接逻辑收进一个函数，后面所有输出只调用一次：

function Link-Text { param($Text, $Url) $PSStyle.FormatHyperlink($Text, [uri]$Url) } Write-Host (Link-Text "项目地址" "https://aka.ms/powershell")

避坑清单

现象：屏幕上出现\e]8;;https://...\e\\之类的怪字符，链接点不了。原因：当前终端不支持 ANSI OSC 8 转义序列。解决：换用 Windows Terminal、iTerm2 或 VS Code 内置终端；tmux 用户确认外层终端也支持再试。

现象：报 CommandNotFoundException 或 FormatHyperlink 找不到。原因：正在运行 Windows PowerShell 5.1，该版本没有 $PSStyle 变量。解决：确认启动的是 pwsh 7.2+，而不是 powershell.exe。

现象：链接能点，但跳转到了错误地址。原因：目标参数传了普通字符串且格式不规范，URI 解析出偏差。解决：统一显式写成 [uri]"https://..." 形式，避免裸字符串。

延伸与资源

实现源码在 src/System.Management.Automation/FormatAndOutput/common/PSStyle.cs，FormatHyperlink 就在其中，可顺带看颜色、下划线等其它 ANSI 能力。
变更记录见 CHANGELOG/7.2.md，"Add support to $PSStyle for strikethrough and hyperlinks" 就是它的出生记录。
仓库克隆命令：git clone https://gitcode.com/GitHub_Trending/po/PowerShell