MacOS（M1）下mssql-cli安装后无法执行命令的求助

原因 #

pip3安装的mssql-cli可执行文件所在目录未被加入系统PATH环境变量，导致zsh无法定位该命令。

解决方案 #

步骤1：定位mssql-cli可执行文件路径 #

执行命令获取安装路径：

pip3 show mssql-cli | grep Location

输出示例：Location: /Users/你的用户名/Library/Python/3.8/lib/python/site-packages
可执行文件通常在该路径的上级bin目录下，即/Users/你的用户名/Library/Python/3.8/bin/mssql-cli

也可以直接用find命令查找：

find ~/Library/Python/3.8 -name mssql-cli -type f

步骤2：将路径添加到zsh的PATH中 #

编辑zsh配置文件：

open -e ~/.zshrc

在文件末尾添加一行（替换为你实际找到的bin路径）：

export PATH="$PATH:/Users/你的用户名/Library/Python/3.8/bin"

保存后执行以下命令使配置生效：

source ~/.zshrc

步骤3：验证命令可用性 #

现在执行mssql-cli -S localhost -U haha即可正常运行。

临时方案（无需修改配置） #

若不想调整环境变量，可直接用绝对路径运行：

/Users/你的用户名/Library/Python/3.8/bin/mssql-cli -S localhost -U haha

额外提示 #

M1 Mac可能存在多版本Python共存情况，确保使用的pip3对应Python 3.8版本。如果安装时用的是其他版本pip（如pip3.9），需找到对应Python版本的bin目录添加到PATH中。

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