配置PowerShell预测性自动补全，提升Windows终端开发效率

微软专家

许多从 macOS 或 Linux 转向 Windows 的开发者都曾感叹 PowerShell 的自动补全不如 zsh 那般智能。实际上，借助 PSReadLine 模块的预测性 IntelliSense 功能，我们完全可以让 PowerShell 拥有接近 oh-my-zsh 的补全体验。以下是一套经过验证的配置方法，适用于 Windows 10 及以上版本中的 PowerShell 5.1 或 PowerShell 7+。

第一步：确认或更新 PSReadLine 模块
PSReadLine 是微软官方维护的 PowerShell 行编辑器增强模块，其 2.2.0-beta 及以上版本才支持预测性 IntelliSense。在 PowerShell 中执行以下命令查看当前版本：

2. Get-Module PSReadLine -ListAvailable | Select-Object Name, Version

复制代码

如果版本低于 2.2.0，则需先安装最新版（建议使用 PowerShell 7+ 内置的版本）。在管理员模式下运行：

2. Install-Module PSReadLine -RequiredVersion 2.2.0-beta4 -AllowPrerelease -Force

复制代码

安装完成后，重启 PowerShell 或执行 Import-Module PSReadLine 重新加载。

第二步：配置预测性补全行为
PSReadLine 的预测性 IntelliSense 由两个核心设置控制：
- PredictionSource：指定补全来源，可以是 History（仅历史记录）或 HistoryAndPlugin（历史记录加插件，如 PSReadLine 的验证器）。
- PredictionViewStyle：指定补全显示样式，包括 ListView（列表视图）和 InlineView（内联视图）。

推荐将两者结合，使用下方的配置写入当前用户的配置文件（$PROFILE）：

2. Set-PSReadLineOption -PredictionSource HistoryAndPlugin
3. Set-PSReadLineOption -PredictionViewStyle ListView

复制代码

ListView 样式会以类似 zsh 的下拉列表显示完整补全建议，开发者可通过方向键选择后按 Enter 接受；InlineView 则在光标后显示灰色提示，按右箭头或 Tab 直接插入。

第三步：保存配置文件并生效
将上述命令添加到 $PROFILE 文件中，可以让每次启动 PowerShell 时自动加载。执行以下命令编辑配置文件：

2. notepad $PROFILE

复制代码

如果文件不存在，会提示创建，选择是。在文件中粘贴如下内容：

2. Set-PSReadLineOption -PredictionSource HistoryAndPlugin
3. Set-PSReadLineOption -PredictionViewStyle ListView

复制代码

保存后关闭，然后执行 . $PROFILE 立即生效。

第四步：验证并优化体验
测试自动补全效果时，你可以先输入几条常用命令（如 cd、ls、git status），然后再次输入相同开头字母，即可看到智能提示。如果希望补全结果基于上下文和参数，可以安装第三方插件如 CompletionPredictor（需 .NET SDK 支持），但纯历史记录模式已能满足大部分日常开发需求。

技术影响分析
这一配置方案实质上利用了 PSReadLine 对 ReadLine API 的扩展，将历史命令和插件输出作为预测源，并通过 Win32 控制台 API 绘制下拉列表或内联提示。对于频繁执行重复性命令的开发者（如 Git 操作、dotnet 命令、WSL 命令），可显著减少击键次数。设置本身零侵入、零依赖，仅修改用户级配置文件，不会影响系统稳定性。若未来需恢复默认，只需删除 $PROFILE 中对应行或重命名文件即可。

常见问题
Q：List view 显示不全或没有背景色？
A：确保使用 PowerShell 7+ 的新版终端（如 Windows Terminal），旧版 conhost.exe 对 Unihan 字符和背景色支持有限。

Q：为什么没有预测任何历史记录？
A：History 预测源依赖当前会话中的历史记录，新打开的会话需积累一定操作。也可通过 Set-PSReadLineOption -HistorySaveStyle SaveAtExit 确保历史持久化。

通过以上步骤，Windows 上的 PowerShell 开发体验将显著提升，不再需要羡慕 zsh 用户。该配置同样适用于 Windows 10/11 内置的 Windows Terminal，建议结合 Oh-My-Posh 主题插件达到颜值与效率双收。

热心网友7

非常感谢楼主分享这么详细的配置教程！之前一直觉得 PowerShell 补全不够聪明，按步骤设置后确实流畅了很多，ListView 样式配合 Windows Terminal 用起来非常顺手。有个小建议：如果之前没用过 $PROFILE，第一次打开可能会提示文件不存在，直接选“是”创建就好，楼主已经写得很清楚了。再次感谢！