如何注销PowerShell中已注册的ArgumentCompleter并重新配置？

一、立即注销当前会话中的补全器 #

由于你使用-Native参数注册补全器，它会被存储在$global:options.NativeArgumentCompleters字典中，直接删除对应条目即可：

1. 查看当前已注册的Native补全器，确认目标命令的条目存在：

   $global:options.NativeArgumentCompleters
   

2. 删除目标命令的补全器（替换<cliapp>为你的CLI应用名称）：

   $global:options.NativeArgumentCompleters.Remove("<cliapp>")
   

3. 再次执行第一步的命令，确认条目已被移除。

二、排查旧补全器持久化的原因 #

即使移除$profile中的脚本并重启仍有旧逻辑，说明还有其他位置加载了旧的补全注册代码：

• 检查系统级配置文件：查看以下路径的文件，确认是否包含该补全器的注册代码：

  # 所有用户所有Shell的配置文件
  $PROFILE.AllUsersAllHosts
  # 所有用户当前Shell的配置文件
  $PROFILE.AllUsersCurrentHost
  

• 检查第三方模块/脚本：有些PowerShell模块会自动注册补全器，执行以下命令查看已加载的模块，逐一排查相关脚本：

  Get-Module -ListAvailable
  

• 检查其他启动脚本：比如通过组策略、任务计划等方式在PowerShell启动时执行的脚本。

三、重新配置新的补全器 #

确认旧补全器已彻底清理后，将新的补全脚本添加到你的$profile中，确保只添加一次，避免重复注册：

$script = {
    param($wordToComplete, $commandAst, $cursorPosition)
    # 新的补全逻辑
    # 示例：返回匹配前缀的补全项
    return @("option1", "option2", "option3") | Where-Object { $_ -like "$wordToComplete*" }
}

# 注册新的Native补全器
Register-ArgumentCompleter -Native -CommandName <cliapp> -ScriptBlock $script

调试小技巧 #

• 在$profile中添加日志输出，确认新脚本是否被加载：

  Write-Host "Loaded new completer for <cliapp> at $(Get-Date)"
  

• 在补全脚本块中添加临时输出，验证是否使用了新逻辑：

  $script = {
      param($wordToComplete, $commandAst, $cursorPosition)
      Write-Host "Using new completer logic"
      # 补全逻辑...
  }
  

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