叹为观止

适用于 PowerShell 7.0 及以上版本

在命令行环境中，重复输入相似的命令是日常工作的常态。无论是启动服务、查询日志还是部署应用，许多命令只是参数略有不同。PSReadLine 2.1 引入的预测智能补全（Predictive IntelliSense）改变了这一局面——它会在你输入时实时展示匹配的历史命令或插件建议，让你可以用一次按键完成整行输入。

预测补全的核心思想是「从过去学习」。默认情况下，它会从命令历史中提取与当前输入前缀匹配的记录，以灰色内联文本的形式显示在光标后方。如果你安装了额外的预测源插件（比如基于 AI 的补全模块），它还能根据语义理解推荐从未执行过的新命令。这种机制让命令行的效率大幅提升，尤其是面对长路径、复杂参数的场景。

本文将从三个层面展开：首先配置 PSReadLine 的预测功能并选择合适的视图模式；然后编写一个自定义预测插件，实现基于文件系统路径的智能建议；最后分享一套完整的快捷键方案，帮助你在日常工作中充分释放预测补全的潜力。

PSReadLine 预测补全配置

预测智能补全需要 PSReadLine 2.1 或更高版本。以下脚本检查当前版本、启用预测功能，并切换到列表视图模式——该模式会在命令行下方展示多条候选建议，比内联视图更适合从多个选项中挑选。

# 检查 PSReadLine 版本
$module = Get-Module PSReadLine -ListAvailable |
    Sort-Object Version -Descending |
    Select-Object -First 1
Write-Host "PSReadLine 版本: $($module.Version)"

if ($module.Version -lt [version]'2.1.0') {
    Write-Host "需要升级 PSReadLine，正在安装..." -ForegroundColor Yellow
    Install-Module PSReadLine -Force -SkipPublisherCheck
    Write-Host "安装完成，请重启 PowerShell。" -ForegroundColor Green
    return
}

# 启用预测智能补全
Set-PSReadLineOption -PredictiveSource History

# 设置视图模式：Inline（内联）或 ListView（列表）
Set-PSReadLineOption -PredictiveStyle ListView

# 配置历史记录保存条数（默认有限，建议调大）
Set-PSReadLineOption -MaximumHistoryCount 10000

# 历史记录去重：忽略连续重复的命令
Set-PSReadLineOption -HistoryNoDuplicates $true

# 历史记录保存路径（确保跨会话持久化）
$historyPath = Join-Path $env:USERPROFILE '.ps_history'
Set-PSReadLineOption -HistorySavePath $historyPath

# 验证配置
$options = Get-PSReadLineOption
Write-Host "`n当前预测配置:" -ForegroundColor Cyan
Write-Host "  预测源: $($options.PredictiveSource)"
Write-Host "  视图模式: $($options.PredictiveStyle)"
Write-Host "  历史上限: $($options.MaximumHistoryCount)"
Write-Host "  去重开关: $($options.HistoryNoDuplicates)"
Write-Host "  保存路径: $($options.HistorySavePath)"

PSReadLine 版本: 2.4.2

当前预测配置:
  预测源: History
  视图模式: ListView
  历史上限: 10000
  去重开关: True
  保存路径: C:\Users\admin\.ps_history

配置完成后，每次在命令行输入内容时，下方会自动弹出匹配的历史命令列表。使用 上箭头 和 下箭头 可以在候选列表中导航，按 右箭头 或 End 接受选中的建议。

自定义预测插件

除了历史记录，PSReadLine 还支持通过 ICommandPrediction 接口注册自定义预测源。下面的示例实现了一个基于文件系统路径的预测插件——当你输入类似 cd 或 code 并加空格时，它会根据当前目录下的子文件夹给出补全建议。

using namespace System.Management.Automation.Subsystem.Prediction

# 定义预测插件类
class FileSystemPredictor : ICommandPrediction {
    [string] $Name = 'FileSystem'
    [string] $Description = '基于文件系统路径的命令预测'

    # 唯一标识
    [Guid] GetId() {
        return [Guid]::new('a1b2c3d4-e5f6-7890-abcd-ef1234567890')
    }

    # 核心预测逻辑
    [void] GetSuggestion(
        [PredictionClient] $client,
        [PredictionContext] $context,
        [System.Threading.CancellationToken] $cancellationToken
    ) {
        $inputText = $context.InputAst.Extent.Text
        $results = [System.Collections.Generic.List[PredictiveSuggestion]]::new()

        # 检测路径型命令前缀
        $pathCommands = @('cd ', 'Set-Location ', 'code ', 'nvim ', 'vim ')
        $matched = $false
        foreach ($cmd in $pathCommands) {
            if ($inputText.StartsWith($cmd, [StringComparison]::OrdinalIgnoreCase)) {
                $matched = $true
                $partial = $inputText.Substring($cmd.Length).Trim()

                # 获取当前目录下的匹配子目录
                $searchPath = if ($partial) {
                    Join-Path (Get-Location) "$partial*"
                } else {
                    Join-Path (Get-Location) '*'
                }

                $dirs = Get-Item -Path $searchPath -Directory -ErrorAction SilentlyContinue |
                    Select-Object -First 5

                foreach ($dir in $dirs) {
                    $suggestion = "$cmd$($dir.Name)"
                    $results.Add([PredictiveSuggestion]::new($suggestion))
                }
                break
            }
        }

        # 未匹配路径命令时，提供常用命令模板
        if (-not $matched -and $inputText.Length -ge 2) {
            $templates = @(
                'Get-ChildItem -Recurse -Filter "*.ps1"'
                'Select-Object -First 10'
                'Where-Object { $_.Length -gt 1MB }'
                'ForEach-Object { $_.FullName }'
            )
            foreach ($t in $templates) {
                if ($t.StartsWith($inputText, [StringComparison]::OrdinalIgnoreCase)) {
                    $results.Add([PredictiveSuggestion]::new($t))
                }
            }
        }

        if ($results.Count -gt 0) {
            $client.Report($results)
        }
    }
}

# 注册插件
$predictor = [FileSystemPredictor]::new()
$subsystem = [System.Management.Automation.Subsystem.SubsystemManager]::
    GetSubsystem([ICommandPrediction])
$subsystem.Register($predictor.GetId(), $predictor)

# 同时启用历史和插件两个预测源
Set-PSReadLineOption -PredictiveSource HistoryAndPlugin

Write-Host "文件系统预测插件已注册。" -ForegroundColor Green

文件系统预测插件已注册。

注册后，当你在命令行输入 cd 并加空格时，预测列表不仅包含历史命令，还会展示当前目录下的子文件夹建议。两种预测源的结果会合并展示，帮助你更快找到目标命令。

高效命令行工作流

预测补全要发挥最大价值，离不开合理的快捷键绑定和搜索习惯。以下脚本将一组常用操作绑定到顺手的热键上，并演示如何优化历史搜索和多行编辑体验。

# ===== 快捷键自定义 =====

# Ctrl+f：接受当前预测建议（比右箭头更顺手）
Set-PSReadLineKeyHandler -Chord 'Ctrl+f' -Function ForwardWord

# Ctrl+d：删除光标后的单词（与 Bash 一致）
Set-PSReadLineKeyHandler -Chord 'Ctrl+d' -Function DeleteChar

# Tab 补全改为菜单式选择（配合预测更直观）
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete

# 上/下箭头：在预测列表中导航时，同时搜索历史
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward

# Ctrl+Shift+o：打开预测列表的详细视图（需要 ListView 模式）
Set-PSReadLineKeyHandler -Chord 'Ctrl+Shift+o' -Function AcceptSuggestion

# ===== 历史搜索优化 =====

# 启用基于前缀的历史搜索（输入部分命令再按上箭头）
Set-PSReadLineOption -HistorySearchCursorMovesToEnd $true

# 增加补全工具提示的显示时长（毫秒）
Set-PSReadLineOption -CommandValidationHandler $null

# ===== 将配置持久化到 Profile =====

$profileContent = @'
# PSReadLine 预测补全配置
Import-Module PSReadLine
Set-PSReadLineOption -PredictiveSource HistoryAndPlugin
Set-PSReadLineOption -PredictiveStyle ListView
Set-PSReadLineOption -MaximumHistoryCount 10000
Set-PSReadLineOption -HistoryNoDuplicates $true
Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
'@

# 写入当前用户的 Profile
$profileDir = Split-Path $PROFILE
if (-not (Test-Path $profileDir)) {
    New-Item -ItemType Directory -Path $profileDir -Force | Out-Null
}
Add-Content -Path $PROFILE -Value $profileContent -Encoding UTF8
Write-Host "配置已追加到 Profile: $PROFILE" -ForegroundColor Green

# 查看当前所有快捷键绑定（筛选自定义的）
Get-PSReadLineKeyHandler | Where-Object {
    $_.Key -in @('Tab', 'UpArrow', 'DownArrow')
} | Format-Table -Property Key, Function, Description -AutoSize

配置已追加到 Profile: C:\Users\admin\Documents\PowerShell\Microsoft.PowerShell_profile.ps1

Key     Function              Description
---     --------              -----------
Tab     MenuComplete           补全当前项或在可用选项间循环
UpArrow HistorySearchBackward 搜索以当前输入为前缀的历史命令
DownArrow HistorySearchForward 搜索以当前输入为前缀的下一条历史命令

配置持久化后，每次打开 PowerShell 都会自动加载这些设置。你可以根据自己的使用习惯调整快捷键映射，比如将 Ctrl+Space 绑定为切换预测视图的开关，或用 Ctrl+r 实现增量历史搜索。

注意事项

1. 版本要求：预测智能补全需要 PSReadLine 2.1+ 和 PowerShell 7.0+。Windows PowerShell 5.1 自带的 PSReadLine 版本过低，需要手动升级，且部分功能（如 ListView）在旧版控制台宿主中不可用。

2. 控制台兼容性：ListView 模式需要 Windows Terminal、VS Code 终端或 iTerm2 等现代终端模拟器。传统的 conhost.exe（Windows 自带命令提示符窗口）仅支持 Inline 模式。

3. 插件注册时机：自定义预测插件必须在 Profile 加载阶段注册，否则每次打开新会话都需要手动执行注册代码。建议将注册逻辑封装在模块的 OnImport 中。

4. 性能影响：预测源如果返回过多结果或查询耗时过长，会导致输入卡顿。建议每个预测源将结果限制在 10 条以内，并在耗时操作中加入 CancellationToken 检查。

5. 历史记录安全：包含敏感信息（密码、Token）的命令会被写入历史文件。可以通过 Set-PSReadLineOption -AddToHistoryHandler 自定义过滤逻辑，阻止特定模式的命令进入历史。

6. 多预测源优先级：当同时启用 HistoryAndPlugin 时，PSReadLine 会合并所有预测源的结果，但不会保证特定顺序。如果需要控制优先级，可以在插件的 GetSuggestion 方法中根据上下文动态调整返回内容的数量。