macOS安装sql-cli后运行mssql提示command not found怎么解决？

核心原因 #

你当前的PATH配置存在错误：PATH环境变量需要添加的是包含可执行文件的目录路径，而非可执行文件本身的完整路径。从安装日志可见，npm生成的mssql软链存放目录为/usr/local/Cellar/heroku-node/12.21.0/bin/，你之前添加的单个可执行文件路径无法被系统识别。

永久修复步骤 #

1. 打开对应shell的配置文件
   • 若使用zsh（macOS默认shell），打开~/.zshrc
   • 若使用bash，打开~/.bash_profile或~/.bashrc
2. 修改PATH配置
   删除原有错误的PATH配置行，新增以下内容：

   export PATH=/usr/local/Cellar/heroku-node/12.21.0/bin:$PATH
   

3. 生效配置
   保存文件后执行对应命令加载配置：
   • zsh环境：source ~/.zshrc
   • bash环境：source ~/.bash_profile

验证修复结果 #

执行which mssql，正常输出为/usr/local/Cellar/heroku-node/12.21.0/bin/mssql，再执行mssql --version能返回版本号即说明配置成功。

临时应急方案 #

无需修改PATH，直接调用完整路径的可执行文件即可：

/usr/local/Cellar/heroku-node/12.21.0/bin/mssql -u sa -p myPassw0rd

额外排查项 #

如果按上述操作仍存在问题，检查两项配置：

• 给软链添加执行权限：chmod +x /usr/local/Cellar/heroku-node/12.21.0/bin/mssql
• 确认当前使用的node版本匹配：执行which node，输出路径应和heroku的node安装路径一致，避免多版本node导致全局包路径冲突

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