如何在Windows 10的Powershell中实现scp远程路径自动补全

首先明确：Win10默认PowerShell自带的scp命令是没有远程路径自动补全能力的，Tab键默认只能补全本地路径，要实现和zsh完全一致的效果，按下面两种可落地的方案操作就行。

前置准备 #

• 确认系统已安装官方OpenSSH客户端：Win10 1809及以上版本默认预装，打开PowerShell输入scp能正常输出帮助信息即为可用；如果没有，在系统设置的「可选功能」列表里搜索OpenSSH客户端安装即可。
• 建议提前配置好SSH公钥免密登录：后续补全过程会自动建立临时SSH连接拉取远端目录列表，需要输密码的场景下会阻塞补全流程，免密登录后体验和本地补全完全一致。

方案1：基于PSReadLine自定义补全钩子（无额外依赖，适配默认PowerShell） #

这个方案不需要安装第三方模块，利用Win10 PowerShell预装的PSReadLine补全框架实现：

• 打开PowerShell配置文件：输入notepad $PROFILE，如果提示文件不存在，先执行New-Item -Path $PROFILE -Type File -Force创建配置文件。
• 在打开的记事本里加入自定义补全钩子逻辑：识别到当前输入行包含scp/sftp命令，且待补全片段符合用户名@主机地址:路径前缀的格式时，自动调用SSH连接拉取对应当前远程目录的文件/文件夹列表，作为Tab补全的候选项。
• 保存配置文件后重启PowerShell，即可触发补全：比如输入scp demo.tar root@10.0.0.5:/home/us<tab>，按Tab就会自动匹配/home/user、/home/upload这类远程路径补全，首次补全因为要建立SSH连接会有1-2秒延迟，连接建立后补全速度和本地路径无差别。

方案2：借助posh-ssh模块快速实现（低配置成本） #

不想手动写补全逻辑的话，用现成的PowerShell SSH模块更省心：

• 在PowerShell中执行Install-Module posh-ssh -Scope CurrentUser，弹出安装确认提示时输入Y完成安装。
• 在$PROFILE配置文件中加入一行Import-Module posh-ssh，保存后重启PowerShell。
• 这个模块内置了完整的scp命令参数补全规则，不仅支持远程路径补全，还能自动识别你SSH配置文件里记录的主机名，直接补全常用的远程服务器地址，减少重复输入。

常见踩坑提醒 #

• 远程路径必须用正斜杠/做分隔符，用Windows本地路径的反斜杠\会导致补全逻辑识别失败。
• 版本兼容性要求：PowerShell版本最低要5.1以上，过老的内置版本不支持PSReadLine的补全钩子能力，升级到最新PowerShell 7.x版本体验会更好。
• 如果补全过程经常卡死，检查SSH连接的超时配置，把连接超时时间调整为10秒以内，避免网络异常时PowerShell长时间等待补全响应。

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