Python导入astropy.wcs提示No module named报错如何解决

• 核心触发原因分两类：一是当前运行代码的Python环境未正确安装astropy，或是安装的astropy版本过旧、安装文件损坏，导致wcs子模块无法被正常加载；二是文件命名冲突，如果你把当前写的代码文件命名为astropy.py，Python导入包时会优先读取你本地的这个同名文件，自然找不到官方库内置的wcs模块。
• 你贴出的代码还存在一个隐藏问题：没有导入Angle类，就算解决了wcs的导入错误，运行到天球坐标定义的行时也会触发NameError。

• 先排查命名冲突：检查代码所在的文件夹，只要存在命名为astropy.py的文件就立刻重命名为其他名称（比如fits_coord_convert.py），同时删除同目录下的__pycache__缓存文件夹，避免旧缓存干扰导入逻辑。
• 修复astropy安装问题：打开你运行代码所用的Python环境对应的终端，执行对应命令重装/升级astropy：
  • pip环境执行：pip install --upgrade --force-reinstall astropy
  • conda环境执行：conda install -c conda-forge astropy
    安装完成后可以在终端执行python -c "from astropy.wcs import WCS; print('导入成功')"，如果能正常打印「导入成功」就说明wcs模块的问题已经解决。
• 补全代码缺失的导入，优化WCS初始化逻辑（直接传文件路径初始化WCS在多HDU的FITS文件中容易识别错坐标系，传入目标HDU的头文件更稳定），修正后的可运行代码如下：

from astropy.io import fits
from astropy.wcs import WCS
from astropy.coordinates import Angle

# 用上下文管理器打开FITS文件，处理完成后自动释放文件占用
with fits.open('Eurybates_sky.fits') as archivo_fits:
    print(archivo_fits.info())
    target_header = archivo_fits[0].header
    print(target_header)
    
    ra = Angle('06d59m31.64s')
    dec = Angle('+29d56m45.5s')
    ra_deg = ra.degree
    dec_deg = dec.degree
    
    wcs = WCS(target_header)
    x_pix, y_pix = wcs.all_world2pix(ra_deg, dec_deg, 1)
    print(f"对应像素坐标：x={x_pix}, y={y_pix}")

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