Python Rasterio库安装超时、安装后导入无模块问题咨询

问题原因说明 #

• 直接执行pip install rasterio或默认源conda安装卡顿、进程卡死：Rasterio依赖GDAL等大量C语言编写的地理空间库，默认源拉取源码包本地编译耗时极长，海外源网络连接不稳定时很容易安装中断。
• 手动安装whl后提示No module named 'rasterio'：一般是安装包版本和当前Python环境版本、系统架构不匹配，或是包被安装到了其他Python环境中，当前运行代码的解释器没有对应安装记录。

前置必做检查（避免装错环境） #

1. 打开Anaconda命令行，激活你需要安装Rasterio的目标环境：
   conda activate 你的目标环境名称
2. 执行命令确认当前环境信息，记下来后续安装要完全匹配：
   python -c "import sys; print('Python版本:', sys.version.split()[0]); print('系统架构:', sys.platform, 64 if sys.maxsize > 2**32 else 32, '位')"
3. 执行命令确认当前调用的pip属于目标环境：
   pip -V
   输出的路径中必须包含你的目标conda环境的文件夹名称，如果路径指向其他Python安装目录，后续安装时请用python -m pip代替直接输入pip，强制调用当前环境的包管理工具。

安装方法1：conda源安装（推荐，自动适配依赖） #

该方法不需要手动安装GDAL，会自动匹配安装所有兼容依赖，出错概率最低：

1. 执行命令添加conda-forge社区源，解决默认源速度慢、版本不全的问题：

conda config --add channels conda-forge
conda config --set channel_priority strict

2. 执行安装命令等待完成即可：
   conda install rasterio

安装方法2：手动whl安装（适配conda安装失败场景） #

如果conda安装始终有问题，可以用手动安装whl的方式：

1. 先清理之前装错的残留包，避免版本冲突：

pip uninstall -y rasterio gdal fiona pyproj

2. 获取和你之前查到的Python版本、系统、位数完全匹配的GDAL、Rasterio whl安装包：
   • 文件名中cp310对应Python3.10、cp311对应Python3.11，win_amd64对应Windows 64位系统，标识不匹配的包装完也无法被识别
3. 先安装GDAL的whl包，再安装Rasterio的whl包，顺序不能颠倒：

python -m pip install 本地GDAL whl文件的完整路径
python -m pip install 本地Rasterio whl文件的完整路径

4. 安装完成后不要切换环境，直接执行验证命令，能正常输出版本号即为安装成功：
   python -c "import rasterio; print('Rasterio安装成功，版本：', rasterio.__version__)"

导入报错排查 #

如果安装完成后仍然提示找不到模块，按以下顺序排查：

• 检查代码编辑器/IDE选中的Python解释器，确认是你安装Rasterio的那个conda环境，不要选到系统全局Python或者其他虚拟环境
• 检查whl包版本标识和当前Python版本是否完全一致，大版本小版本都不能错，不匹配的包卸载后重新找对应版本安装
• 不要在虚拟环境未激活的状态下执行安装命令，否则包会被安装到默认Python环境中，虚拟环境内无法调用

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