MacOSX下Python包已安装但关联可执行脚本无法调用

这事儿本质是两种安装方式在可执行脚本的路径处理上有差异，再加上MacOS多Python版本环境的特殊性导致的，我给你拆解一下：

1. python setup.py install的问题出在哪？ #

当你运行这个命令时，setuptools会把console_scripts定义的mypkg脚本安装到当前Python环境的bin目录，但这个目录很可能不在你的zsh系统PATH里：

• 如果你用的是MacOS手动安装的Python 3.9，setup.py install默认会把脚本放到用户专属的Python目录，比如~/Library/Python/3.9/bin，这个目录默认没有被添加到系统PATH中，所以zsh找不到mypkg命令。
• 另外，如果你的python命令不小心指向了其他Python版本（比如系统自带的旧版本），脚本会被安装到错误的环境里，自然也调用不到。

你可以验证一下：运行python -m site --user-base，拿到用户目录路径后，去[路径]/bin里看看有没有mypkg脚本。如果有，说明就是PATH的问题——把这个bin目录添加到~/.zshrc里（比如export PATH="$HOME/Library/Python/3.9/bin:$PATH"），重启终端后mypkg就能用了。

2. pip install .为什么能解决？ #

pip作为现在Python官方推荐的包管理工具，在处理可执行脚本时更智能：

• 它会自动把生成的脚本放到已经在系统PATH中的目录，比如/usr/local/bin（全局安装）或者你当前Python虚拟环境的bin目录，确保终端能直接找到命令。
• 同时，pip会严格关联你当前使用的Python版本（尤其是你切换到对应3.9的pip后），不会出现脚本安装到错误环境的情况。

额外提醒：尽量用pip代替直接运行setup.py #

现在官方已经不推荐直接用python setup.py install这种方式了，pip会处理更多环境细节（比如依赖管理、路径配置、虚拟环境适配），能避免很多这类奇怪的路径问题。

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