PSCompletions (psc)

介绍

喜欢这个项目？请给它 Star ⭐️ 或 赞赏 💰

TIP

• PowerShell (Core): 跨平台的 PowerShell，运行 pwsh/pwsh.exe 启动
• Windows PowerShell (Desktop): Windows 系统内置的 PowerShell，运行 powershell/powershell.exe 启动
• 它们都可以使用 PSCompletions，但是更推荐 PowerShell (Core)

一个补全管理器，为 PowerShell 带来更出色、更简便的 Tab 补全体验。

• 内置的补全库
• 更强大的模块补全菜单
• 支持多种语言: en-US, zh-CN 等
• 根据命令历史记录动态排序补全项
• 与其他工具协作
  • argc-completions
  • Carapace
  • PSFzf

演示

TIP

点击查看 Bilibili 中的介绍及教学视频

新的变化

请查阅 更新日志

贡献

请查阅 贡献指南

安装

1. 安装模块

   • Install-Module

     Install-Module PSCompletions

   • Install-PSResource

     Install-PSResource PSCompletions

   • Scoop

     • 添加 abyss bucket (Github 或 Gitee)

     • 安装它

       scoop install abyss/abgox.PSCompletions

2. 导入模块

   Import-Module PSCompletions

TIP

• 如果使用了 . $PROFILE，请运行 psc 以重载模块的按键绑定及数据
• 参考: Source profile

使用

• 使用 内置的补全库，以 git 补全为例

  1. 使用 psc add git 添加补全
  2. 输入 git，按下 Space(空格键) 和 Tab 键获取命令补全

• 使用官方补全或其他的补全库

  • 如果存在官方补全，可以使用类似的命令

    xxx completion powershell | Out-String | Invoke-Expression

  • 使用其他的补全库: argc-completions, Carapace

  • 更多详情，参考 菜单增强

• 使用 PSFzf 作为补全菜单

致谢

• PSReadLine: PowerShell 的一个内置模块，增强命令行编辑体验
  • PSCompletions 使用了 Set-PSReadLineKeyHandler 和 Get-PSReadLineOption
• PS-GuiCompletion: 适用于 PowerShell 的 GUI 风格的制表符补全菜单
  • PSCompletions 的 模块补全菜单 受到了它的启发

补全