Github Copilot CLI别名ghcs、ghce无法识别问题求助

问题描述 #

• gh copilot suggest和gh copilot explain命令可正常执行
• 尝试将上述命令简化为别名ghcs和ghce后，运行ghcs "create new dir"抛出以下错误：

ghcs : The term 'ghcs' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ ghcs "new dir"
+ ~~~~
    + CategoryInfo          : ObjectNotFound: (ghcs:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

环境 #

Windows系统，VSCode搭配PowerShell，已安装Microsoft PowerShell扩展

已尝试操作 #

• 运行gh copilot alias命令，PowerShell文件夹中生成了相关文件，但问题未解决
• 通过New-Item -Force $PROFILE创建新PowerShell配置文件，并添加官方推荐代码，依旧无效

解决步骤 #

1. 确认别名配置文件的正确性 #

• 执行以下命令查看官方生成的PowerShell别名定义：

  gh copilot alias -- pwsh
  

  输出应包含以下函数定义：

  function ghcs { gh copilot suggest @args }
  function ghce { gh copilot explain @args }
  

• 检查配置文件是否存在：

  $GH_COPILOT_PROFILE = Join-Path -Path $(Split-Path -Path $PROFILE -Parent) -ChildPath "gh-copilot.ps1"
  Test-Path $GH_COPILOT_PROFILE
  

  若返回False，重新生成配置文件：

  gh copilot alias -- pwsh | Out-File (New-Item -Path $GH_COPILOT_PROFILE -Force)
  

2. 确保配置文件已加载到PowerShell #

• 检查$PROFILE文件内容，确认包含加载copilot配置的语句：

  Get-Content $PROFILE
  

  若没有. $GH_COPILOT_PROFILE这一行，手动添加：

  Add-Content -Path $PROFILE -Value ". $GH_COPILOT_PROFILE"
  

• 立即加载配置文件：

  . $PROFILE
  

  之后直接测试ghcs "create new dir"

3. 调整PowerShell执行策略 #

• 查看当前执行策略：

  Get-ExecutionPolicy
  

  若结果为Restricted，需要允许本地脚本运行：

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  

  执行时输入Y确认即可

4. 验证VSCode的PowerShell环境 #

• 在VSCode新终端中执行$PROFILE，确认当前使用的配置文件路径与你修改的路径一致
• 区分系统PowerShell（5.1）和PowerShell Core（7+）的配置文件路径：
  • 系统PowerShell：C:\Users\<你的用户名>\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
  • PowerShell Core：C:\Users\<你的用户名>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
    确保修改的是当前终端对应的配置文件

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