Windows Terminal 最近几年几乎成了 Windows 用户换终端的首选，颜值高、标签页好用、配置也灵活。但我发现不少朋友把它装好之后，天天吐槽“怎么还是不能自动补全”，每次敲命令还得靠肌肉记忆。其实这里有个特别容易踩的误区：Windows Terminal 本身只是个“壳”，它负责的是窗口、标签、主题、字体这些外观和交互，至于命令能不能补全，那是 shell 的事。也就是说，你在 Windows Terminal 里跑 PowerShell、CMD、WSL 里的 bash，用的分别是三套不同的补全机制。这篇东西我就把这几条路的配置方法完整盘一遍，从原理到实操，再到我踩过的坑，一次性讲清楚。
这个话题适合谁？如果你每天都在用 Windows Terminal 敲 PowerShell、经常在 WSL 里做开发，或者只是想让 CMD 不那么难用，这篇文章都适用。补全配好之后，最大的感受不是“少敲几个字母”，而是输入命令时的思路会变得更顺——看到灰色提示或列表里出现候选，脑子不用再费力记参数。
1. 先搞清楚一件事：Windows Terminal 不负责补全，Shell 才负责
1.1 很多人装完 Terminal 后，补全“没有生效”的真正原因
我先说结论：Windows Terminal 默认情况下确实不会给你任何自动补全。你按 Tab 之后的补全行为，是底层 shell 决定的。比如你在 PowerShell 里按 Tab，能补全的是 PowerShell 模块、命令、文件路径，这是 PSReadLine 和 PowerShell 引擎在干活；你在 CMD 里按 Tab，补全的是文件路径，这是 cmd.exe 自带的一个老功能；你切到 WSL 的 bash 里，补全规则又变成 bash-completion 这一套。
所以“Windows Terminal 自动补全”这个需求，本质上的解法是：把 Windows Terminal 当成一个平台，然后在里面运行的各款 shell 分别做好补全增强。这就像你买了个新显示器，图像清不清晰，不仅取决于显示器本身，还取决于显卡驱动和系统设置，一个道理。
我在实际配置时见过太多人只折腾 Terminal 的外观，把背景搞成毛玻璃、主题换得花里胡哨，结果一敲命令还是白板一块。不是说外观不重要，而是补全这种提升“输入效率”的东西应该优先配好。外观是给别人看的，补全是给自己用的，优先级得搞清楚。
1.2 各 shell 的补全方案选型对比
我在多台机器上试过不同的组合，下面这个表格基本可以覆盖绝大多数使用场景。
| Shell | 默认补全能力 | 推荐增强方案 | 难度 |
|---|---|---|---|
| PowerShell 5.1 / 7.x | 按 Tab 补全命令和路径 | PSReadLine 历史预测补全 + 菜单补全 | 低 |
| CMD | 仅补全文件路径 | Clink | 中 |
| WSL bash | 有基础补全，但不带历史建议 | bash-completion + 可选的 zsh 方案 | 低 |
| WSL zsh | 带基础补全，但不如 zsh-autosuggestions 顺手 | oh-my-zsh + zsh-autosuggestions | 中 |
如果你平时主要在 PowerShell 里干活，我的建议是先花十分钟把 PSReadLine 的预测补全配好，这个性价比最高。Windows Terminal 下默认新建标签页就是 PowerShell，大部分用户只要做完这一块，就已经能感受到“现代终端”的体验了。
这里强调一下：不是所有补全都必须用 Windows Terminal 的“设置界面”去开启，因为 Terminal 的设置界面里根本没有“自动补全”这个开关。真正的配置几乎都写在 shell 的配置文件里，比如 PowerShell 的$PROFILE、bash 的.bashrc。
2. PowerShell 补全配置：一个 $PROFILE 文件就让补全好用十倍
2.1 安装 PSReadLine 并准备好配置文件
PowerShell 5.1 自带的 PSReadLine 版本比较老，很多新功能没有，所以第一步先升级它。打开 Windows Terminal，进入 PowerShell，执行：
Install-Module PSReadLine -Force -AllowClobber装完后确认一下版本：
Get-Module PSReadLine | Select-Object Version新版 PSReadLine 2.2 以上有“预测补全”的关键能力。如果你用的是 PowerShell 7，通常内置的版本已经够新，但还是建议手动升级一次，版本差异真的会影响体验。
接下来打开 PowerShell 的配置文件：
if (!(Test-Path $PROFILE)) { New-Item -Path $PROFILE -ItemType File -Force } notepad $PROFILE把下面这段基础配置写进去：
Import-Module PSReadLine # 从历史记录中提供预测建议 Set-PSReadLineOption -PredictionSource History # 预测建议显示成下拉列表 Set-PSReadLineOption -PredictionViewStyle ListView # 使用 Windows 风格的编辑模式 Set-PSReadLineOption -EditMode Windows # 让 Tab 键支持菜单补全 Set-PSReadLineKeyHandler -Key Tab -Function MenuComplete保存后重新打开一个标签页，或者执行. $PROFILE让配置立刻生效。这时你输入之前敲过的命令前缀，下面就会弹出一个列表，上下方向键可以选择，回车直接执行，非常直观。
2.2 关键参数逐个解释：PredictionSource、PredictionViewStyle、EditMode
很多教程只会让你“复制粘贴这段配置”，但如果你不知道每个参数是什么意思，后面想调风格就会一脸懵。
-PredictionSource接受History或Plugin。History是让 PowerShell 从你之前输入过的命令历史里找匹配项，比如你昨天敲过一条很长的az vm create --resource-group ...，今天再敲az就会自动在弹出的列表里看到这条命令。Plugin则是给第三方预测插件用的，比如微软官方的Az.Tools.Predictor，后面我会专门讲。
-PredictionViewStyle有InlineView和ListView两种。InlineView是在当前光标后面直接显示灰色半透明的建议文本，看到合适的按右方向键就接受，非常像 Fish Shell 或者 zsh-autosuggestions 的效果。ListView是在当前输入下面弹出一个下拉列表，可以上下箭头选择，信息量更大。我个人推荐ListView，尤其是命令历史很多的时候，列表模式的命中率高得多。
-EditMode Windows是让 PowerShell 支持 Windows 风格的按键，比如 Ctrl+C 复制、Ctrl+V 粘贴，还有方向键移动光标。如果你之前用惯了 CMD，用这个模式几乎没有学习成本。如果你是从 Linux 那边过来的，可以保持Emacs模式，默认就是。
2.3 InlineView 和 ListView 怎么选，实测体验分享
我在两台电脑上分别用了两种风格一段时间。一台配置弱一点，开的是 InlineView，因为它的 UI 开销极小，直接在同一个输入行区显示灰色提示，按右方向键就补全，缺点是一次只能看到一个候选项。另一台主力机器用 ListView，因为我的历史记录特别长，2000 多条，列表模式能一下看到五六个候选，效率高不少。
如果你的历史记录里重复命令很多，我更推荐 ListView。比如你经常在git checkout和git cherry-pick之间切换，输入git c后列表会把两个都列出来，直接上下选，比 InlineView 逐个翻要舒服。如果只是想要“轻量、不打扰”的感觉，那就 InlineView 配-PredictionSource History就够了。
配置完了记得测试几个典型场景：
- 随便敲几条命令，比如
Get-Process、Get-Service、Set-Location ~。 - 新开标签页，输入
Get-，理论上列表会弹出刚才那几条命令。 - 按上下键导航，回车执行。
如果这个流程没问题，说明 PowerShell 的预测补全已经生效了。
3. 不止历史补全：让 PowerShell 能够补全命令参数
3.1 历史记录补全的局限性
只做历史补全，用几天后你会发现一个问题：它只能补全你之前敲过的命令。如果你换了台机器、或者命令记不全，历史补全就无能为力了。比如我想用az创建一个 VM，但命令参数太复杂，之前也没敲过，就没法靠历史记录提示出来。
这时候需要的是“命令参数补全”，也就是按 Tab 时把某个命令支持的子命令、参数、枚举值列出来。PowerShell 本身有TabExpansion2机制，很多模块会向它注册自己的补全规则。比如 Git 的 PowerShell 模块posh-git就带了分支名的补全；Docker、Azure CLI 这些工具也都有自己的 PowerShell 补全脚本。
为了让补全更全面，我建议做两件事。第一，安装posh-git：
Install-Module posh-git -Force Import-Module posh-git装完后在 git 仓库里输入git checkout加一个空格，再按 Tab，就能看到本地分支列表。这个体验，说实话，比 Git Bash 原生补全还舒服。
第二，为常用 CLI 工具生成补全脚本。以 Azure CLI 为例：
Register-ArgumentCompleter -Native -CommandName az -ScriptBlock { param($wordToComplete, $commandAst, $cursorPosition) az completion --command $wordToComplete 2>$null | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) } }这段配置可以放进$PROFILE。配好之后，az命令的子命令就能在 Tab 键下实现了。注意，工具的官方文档里通常都有补全集成说明，不同工具配置方式类似，看一遍官网比找第三方教程更靠谱。
3.2 接上第三方预测插件，让补全像“脑筋急转弯”一样聪明
历史补全解决“以前敲过”，参数补全解决“能不能列出选项”，那问题又来了：如果我想把两者融合，比如输入git c时，既能看到历史输入过的git checkout，又能看到git commit这种补全候选，怎么办？
PSReadLine 2.2 以上支持Plugin预测源，可以挂载外部预测引擎。微软官方的Az.Tools.Predictor就是一个经典例子，它会把 Azure 命令的参数、用法直接接进预测列表。安装很简单：
Install-Module Az.Tools.Predictor -Force Enable-AzPredictor -AllSession这个插件装完，使用 Azure CLI 时输入az vm，预测列表里会直接出现常见的create、delete、list等操作，非常省心。如果你不搞 Azure，也可以留意有没有对应项目的预测插件，比如PSScriptAnalyzer就有插件能给出脚本编写的提示。
要启用插件预测，把$PROFILE里这段改掉：
Set-PSReadLineOption -PredictionSource HistoryAndPlugin注意，新版本里HistoryAndPlugin才是正确的写法，如果你用Plugin，历史预测会消失。这个细节我当时没注意，一度以为插件把历史记录功能覆盖了，折腾了半天。
3.3 自定义 Tab 补全逻辑，让常用命令更快
当补全涉及一些自定义函数时，你可能希望指定它补全某些字符串。比如我写了一个Restart-Dev函数，它接受环境名参数，我希望输入Restart-Dev <Tab>时能列出来dev、test、prod。用 PSReadLine 的Register-ArgumentCompleter可以实现：
Register-ArgumentCompleter -CommandName Restart-Dev -ParameterName Environment -ScriptBlock { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters) @('dev','test','prod') | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) } }写完重载 Profile，然后在命令行试一下：
Restart-Dev devTab 两次就能看到候选项。这个能力非常强大，几乎可以把项目里的任何命令都做成“带提示”的形式，团队内部共享一套$PROFILE时效率提升特别明显。
4. WSL 侧的补全：让 Bash 和 Zsh 也跟上来
4.1 WSL 里 Bash 补全为什么默认不全，怎么救
如果你在 Windows Terminal 里装了 WSL，打开 Ubuntu 后用 bash，会发现按 Tab 只能补全文件路径，像git、systemctl、apt这些命令的子命令和参数，很多补不出来。原因是宿主机 Ubuntu 的 bash-completion 包没装，或者装了没启用。
解决办法很简单：
sudo apt update sudo apt install bash-completion装完之后检查一下/etc/bash.bashrc或者用户目录的.bashrc里有没有相关配置。新版 Ubuntu 一般会自动加载，但如果没生效，手动加一段：
if [ -f /usr/share/bash-completion/bash_completion ]; then . /usr/share/bash-completion/bash_completion fi保存后运行：
source ~/.bashrc这时你输入git che再按 Tab，就会自动补全成git cherry-pick并弹出可能的子命令，状态一下就不一样了。我遇到过最典型的坑是，装完 bash-completion 后发现git补全还是不行，折腾半天才意识到 WSL 里装的是旧版 git，完成的注册脚本不在系统默认路径里。后来用apt upgrade git升到新版后，补全才真正完整。
4.2 Zsh 自动建议：zsh-autosuggestions 是不少人的终极选择
Linux 用户里很多人会直接换 zsh，再配 oh-my-zsh 和 zsh-autosuggestions。这套组合在 WSL 里同样能用，而且体验非常接近 Fish Shell 的“灰色建议”。
先安装 zsh：
sudo apt install zsh -y chsh -s $(which zsh)然后装 oh-my-zsh：
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"再装自动建议插件：
git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions在~/.zshrc里加上：
source ~/.zsh/zsh-autosuggestions/zsh-autosuggestions.zsh安装后，输入命令前缀时会在光标后出现一个灰色的建议，按右方向键接受。默认建议颜色可能和背景不搭，看不清楚，可以调高亮样式：
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=#808080"实际用下来，zsh-autosuggestions 的预测是基于命令历史的，而且它的建议算法比较智能，连“你上次命令的最后一段刚好是今天需要用的文件名”这种场景都能预测到，非常神奇。如果你觉得 zsh 的插件管理和主题更对味，那直接在 WSL 里转到 zsh 是值得的。
4.3 在 Windows Terminal 里切换默认 Shell，让补全配置随终端启动加载
WSL、PowerShell 都配好之后，还有一个细节：Windows Terminal 打开时默认跑哪个 shell。很多人配好 WSL 补全后，打开 Terminal 还是进 PowerShell，于是总觉得“没生效”。
打开 Windows Terminal 设置（Ctrl+,），找到“默认配置文件”，改成 Ubuntu 或者你喜欢的 shell。或者在配置文件里直接改默认：
"defaultProfile": "{你那个 Ubuntu 配置的 GUID}"GUID 可以在设置界面的“启动”列表里看到。这样每次打开 Windows Terminal，默认就进入带补全的环境，不用手动切换。
另外，如果你改了 WSL 里的.bashrc或.zshrc，不用重启 Windows Terminal，重新开一个 WSL 标签页就能生效，除非你改了 Windows Terminal 自己的设置，才需要重启。这个细节能省不少冤枉时间。
5. 周边搭配与常见问题排查：补全之后你还会遇到的几件事
5.1 顺手把 Windows Terminal 的透明度、主题调好（给你的补全一个好看的舞台）
既然热搜里有“Windows Terminal 怎么配置透明效果”，我就把这块也顺手说一下。配置透明效果，其实和补全没关系，但一个赏心悦目的终端确实会提升使用意愿，所以我每次配完补全都会顺手调一下。
新版 Windows Terminal 里最简单的路径是：设置 → 配置文件 → 外观 → 透明度。你可以直接在设置界面里拖动“透明度”滑块，或者打开 JSON 配置文件修改：
"profiles": { "list": [ { "name": "Windows PowerShell", "opacity": 85, "useAcrylic": true } ] }opacity是透明度的百分比，100 为不透明，0 为全透明。useAcrylic是毛玻璃效果开关，实测下来毛玻璃对性能有一定要求，老机器上建议关掉，直接用普通透明即可。
配色方面，我个人习惯选较深的背景色，然后把预测补全的灰色字调亮一档，不然深色背景上的浅灰建议很容易看漏。字体方面，推荐把fontFace设成 Cascadia Code PL 或 JetBrains Mono，等宽字体对命令行对齐非常重要。
5.2 常见问题速查：补全不生效、颜色看不清、CMD 太弱怎么办
这里总结几个我实际遇到的问题，按排查逻辑列成表格，方便你照着查。
| 现象 | 大概率原因 | 验证方法 | 解决办法 |
|---|---|---|---|
| PowerShell 输入历史命令前缀没有预测 | 没加载 PSReadLine 或版本太旧 | Get-Module PSReadLine | 执行Install-Module PSReadLine -Force，检查$PROFILE |
| 预测列表悬在半空，按方向键变历史记录 | PredictionViewStyle不是 ListView | 输入Get-PSReadLineOption | 设置Set-PSReadLineOption -PredictionViewStyle ListView |
| 按 Tab 变成缩进而不是补全 | EditMode 是 Emacs 且没有绑定 Tab | 输入Get-PSReadLineKeyHandler -Key Tab | 改成 Windows 模式或绑定MenuComplete |
| WSL git 子命令补全不出来 | bash-completion 没装或 git 版本旧 | dpkg -l bash-completion | 安装 bash-completion，升级 git |
| 灰色建议颜色和背景太接近 | zsh-autosuggestions 默认颜色问题 | 看~/.zshrc | 设置ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE |
| CMD 下没有自动补全 | CMD 的补全能力太弱 | 用 Clink | 安装 Clink |
| VS Code 里自动补全太吵想关掉 | 编辑器设置影响 | Ctrl+,搜quickSuggestions | 把editor.quickSuggestions里的 other/comments/strings 设为 off |
5.3 CMD 用户的最低成本补全方案：Clink
如果你因为工作原因离不开 CMD，Windows Terminal 里的 CMD 也是可以救一下的，方法是用 Clink。Clink 能把 bash 风格的补全带进 cmd.exe，支持历史预测、自动补全命令参数，甚至 Lua 脚本扩展。
安装很简单，去 Clink 官网下载安装包，装完后打开 CMD 标签页，就能看到它自动加载。默认行为是按 Ctrl+R 做历史搜索，输入命令时也会有类似 bash 的补全建议。Clink 本身还能配合 Windows Terminal 使用，因为它其实就是给 cmd.exe 进程注入了补全能力。
我平时几乎不用 CMD，但偶尔会打开跑一些第三方批处理脚本，装上 Clink 之后，至少按 Tab 补全路径、翻历史记录这两件事舒服多了。
5.4 附带的经验：编辑器自动补全的关闭与调整
关于“vscode 自动补全怎么关闭”，这个和 Windows Terminal 的补全思维完全不同。VS Code 里的智能提示来自语言服务器，如果你觉得写代码时老弹补全窗很烦，可以按Ctrl+Space手动触发，也可以在设置里：
"editor.quickSuggestions": { "other": "off", "comments": "off", "strings": "off" }这一段放在这里是想提醒你：命令行的自动补全和代码编辑器的自动补全，驱动逻辑不是一回事，别把两边的经验混着用。比如 VS Code 里可以用editor.suggestOnTriggerCharacters控制触发字符，但 PowerShell 终端里不适用。
同样地，有人问“STM32CubeIDE 自动补全代码”，那是嵌入式 IDE 的 CDT Content Assist，快捷键是 Alt+/，配置路径在 Window → Preferences → C/C++ → Editor → Content Assist。这个跟 Windows Terminal 补全就更没关系了，但原理上都是“上下文感知地给出候选”，理解了补全的本质，换什么编辑器都能快速上手。
6. 写在日常配置之后的一点个人习惯
所有配置都做完之后，我最喜欢的状态是：打开 Windows Terminal，默认进入 PowerShell，输入git checkout d，ListView 会弹出之前 checkout 过的几个分支名，方向键一按，回车执行。整个过程一秒钟都不需要。
我个人在实际使用中还会做三件事。第一，历史记录数量调大一点，PSReadLine 默认记录数够用，但Set-PSReadLineOption -MaximumHistoryCount 10000能保住更多长命令，预测命中率更高。第二，定期清理无效历史，太久没用的命令会让预测列表变得很杂，我一般把Clear-History绑成一个快捷键。第三，把常用的项目启动命令封装成 PowerShell 函数，再给函数写参数补全，这样只要有新同事加入，把$PROFILE发过去，他的终端也能一夜之间变得好用。
最后还有个小技巧：如果哪天补全变得特别卡，先检查是不是 PSReadLine 版本太老，再检查是不是 WSL 侧的插件太多。终端补全这个东西，本体是廉价的，真正值得花时间的是“怎么把补全内容调得像自己的第二大脑”。按这套配置走一遍，你大概率也会回来后感谢那个愿意折腾的自己。
