Linux环境下PowerShell无法识别sqlpackage命令问题求助

故障根因 #

Linux平台下PowerShell与Bash的环境变量加载逻辑相互独立，系统更新后原Bash配置中录入的sqlpackage安装路径未同步到PowerShell的$env:PATH中，是该问题的核心诱因。

排查修复步骤 #

• 第一步：获取sqlpackage实际安装路径
  在可正常执行命令的Bash中执行：

  which sqlpackage
  

  记录返回的完整路径，常见路径为/usr/bin/sqlpackage或~/.dotnet/tools/sqlpackage。
• 第二步：验证路径有效性
  打开PowerShell，直接使用第一步获取的全路径调用sqlpackage测试，示例：

  /home/yourname/.dotnet/tools/sqlpackage /a:Extract /scs:"Data Source='$sourceServer';Initial Catalog='$sourceDatabase'; User ID='$sqlUser';Password='$sqlPass'" /tf:$dacpac /p:DacApplicationName=Ubiquite /p:IgnorePermissions=True /p:IgnoreUserLoginMappings=True >> $log
  

  若可正常执行，即可确认是PowerShell环境变量未包含对应路径导致的问题。
• 第三步：永久修复
  二选一即可：
  1. 同步路径到PowerShell配置
     执行以下命令打开PowerShell启动配置文件（不存在则自动创建）：

     New-Item -Path $PROFILE -ItemType File -Force
     notepad $PROFILE
     

     在配置文件末尾添加如下内容（将路径替换为第一步获取的sqlpackage所在目录，如/home/yourname/.dotnet/tools）：

     $env:PATH += ":/path/to/sqlpackage/directory"
     

     保存文件后重启PowerShell即可生效。
  2. 创建公共软链接
     在Bash中执行如下命令，将sqlpackage链接到所有shell都可识别的公共路径：

     sudo ln -s /full/path/to/sqlpackage /usr/local/bin/sqlpackage
     

     执行完成后两个Shell均可直接调用sqlpackage命令。

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