Mac安装Astropy后执行import报错：No module named 'astropy'原因咨询

我之前在Mac上也碰到过完全一样的坑！这个报错本质是Python版本/环境不匹配导致的，咱们来一步步搞清楚原因和解决办法：

问题根源 #

你用pip install --user astropy显示安装成功，但运行脚本时找不到模块，核心原因有两个：

• pip和Python版本不对应：Mac系统里通常会同时存在多个Python环境（比如系统自带的Python、Homebrew安装的Python、虚拟环境等），你用来安装包的pip，和你运行脚本时调用的python，可能属于不同的Python版本，导致安装的Astropy不在当前Python的搜索路径里。
• --user安装路径未被Python识别：--user参数会把包安装到当前用户的专属目录（比如~/Library/Python/3.9/lib/python/site-packages），如果你的Python解释器没有把这个目录加入搜索路径，自然找不到模块。

解决步骤 #

1. 确认Python和pip的版本匹配 #

先搞清楚你运行脚本用的是哪个Python：

# 查看当前运行脚本的Python路径
which python
# 或者如果用的是Python3，执行
which python3

再查看你用来安装包的pip路径：

which pip
# 对应Python3的话执行
which pip3

如果两者的路径不匹配（比如python是系统自带的，pip是Homebrew的），就用和Python对应的pip重新安装：

# 比如你用python3运行脚本，就用pip3安装
pip3 install --user astropy

2. 用Python自带的pip模块确保版本一致 #

最稳妥的方式是直接通过Python的-m参数调用pip，这样100%能保证和你使用的Python版本对应：

# 替换成你实际用的Python命令（python或python3）
python3 -m pip install --user astropy

3. 检查Python的搜索路径 #

如果还是不行，先确认Python能不能找到Astropy的安装目录：
运行Python终端，输入以下代码：

import sys
print(sys.path)

看看输出里有没有包含~/Library/Python/X.Y/lib/python/site-packages（X.Y是你的Python版本，比如3.8）。如果没有，你可以手动把这个路径加入sys.path，或者直接用正确的pip重新安装。

4. 检查是否在虚拟环境中 #

如果你用了虚拟环境（比如venv、conda），一定要先激活环境再安装包，否则pip会把包装到全局或用户目录，而虚拟环境里的Python根本找不到这些包。

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