Jupyter提示astropy模块未安装但终端显示依赖已满足问题

核心诱因是终端执行安装操作绑定的Python解释器，和Jupyter当前运行代码调用的Python内核不属于同一个环境，终端安装的包不在Jupyter的包搜索路径里，按以下步骤排查修复： #

1. 先确认双端Python路径是否匹配 #

• 在Jupyter新建代码单元格，执行以下命令，输出Jupyter实际使用的Python解释器绝对路径：

import sys
print(sys.executable)

• 打开你之前执行astropy安装命令的终端，执行对应命令输出终端默认绑定的Python路径：
  • macOS/Linux系统执行：which python3
  • Windows系统执行：where python
    如果两个路径输出不一致，可直接定位为环境不匹配问题。

2. 分场景修复 #

场景A：双端Python路径不一致 #

直接给Jupyter正在使用的Python环境安装astropy即可，不要直接用裸pip install命令：
把第一步Jupyter输出的完整Python路径复制下来，在终端执行以下格式的命令：

<替换成你复制的Jupyter Python路径> -m pip install astropy

举个实际例子，如果Jupyter输出路径是/opt/miniconda3/envs/astro/bin/python，对应执行命令就是/opt/miniconda3/envs/astro/bin/python -m pip install astropy，安装完成后重启Jupyter内核即可正常导入。

场景B：双端路径完全一致仍报导入错误 #

按优先级依次排查以下问题：

• 虚拟环境内核未注册：如果你使用conda/venv等虚拟环境，先在终端激活对应环境，执行以下命令将环境注册为Jupyter可用内核，重启Jupyter后选择对应名称的内核运行代码：

pip install ipykernel
python -m ipykernel install --user --name=你的自定义环境名

• 安装文件损坏：执行强制重装命令覆盖可能损坏的安装文件：

<对应Python路径> -m pip install --force-reinstall astropy

• 文件名冲突：检查Jupyter当前工作目录下，是否存在自己命名为astropy.py的文件、或是名为astropy的文件夹，这类命名会和官方库的导入路径冲突，重命名冲突文件/文件夹即可。

3. 修复验证 #

修复完成后在Jupyter单元格执行以下代码，能正常输出版本号即代表修复成功：

import astropy
print(astropy.__version__)

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