Mac系统下多python3路径版本、模块加载差异问题咨询

两个系统级Python 3路径的区别 #

• /usr/bin/python3：是macOS系统预置的Python 3入口包装器，本身不包含Python运行时实现，调用时会自动指向当前激活的Xcode CommandLineTools内置的Python实例，所以你查询版本时和CommandLineTools路径下的Python版本一致，均为3.8.9。
• /Library/Developer/CommandLineTools/usr/bin/python3：是Xcode命令行工具集内置的Python 3实际运行实例，属于苹果官方提供的开发工具链的一部分，供Xcode、make等原生开发工具调用。

直接执行python3版本不匹配的原因 #

你直接调用python3得到3.7.9版本，核心原因是环境变量PATH的优先级问题：whereis命令只会查询系统预置的二进制路径，不会扫描用户自定义的PATH路径；而执行命令时shell会按PATH配置的路径从前往后匹配，第一个命中的二进制文件就是实际调用的实例。
你可以执行which -a python3查看所有已注册的python3路径，输出结果的第一个路径就是你直接执行python3时实际调用的3.7.9版本，这个版本大概率是你之前通过Homebrew、Anaconda等第三方工具安装的，安装时自动把它的路径写入了shell配置文件（.zshrc/.bash_profile/.bashrc）的PATH靠前位置，优先级高于系统自带的/usr/bin路径。

模块加载不一致的原因 #

每个Python运行实例都有独立的第三方模块安装目录（site-packages），互相不共享：

• 你给CommandLineTools下的Python 3.8.9安装过my_custom_module，所以全路径调用时可以正常导入
• 优先级更高的Python 3.7.9实例的site-packages目录下没有安装该模块，所以直接调用python3时会抛出ModuleNotFoundError

修复方案 #

如果需要默认使用系统自带的Python 3.8.9，可在shell配置文件末尾添加别名：

alias python3="/Library/Developer/CommandLineTools/usr/bin/python3"

修改完成后执行source ~/.zshrc（zsh环境）或source ~/.bash_profile（bash环境）即可生效。

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