pip install pyproj 在 macos（尤其 apple silicon）和部分 linux 环境易失败，因需编译链接系统级 c 依赖（如 libproj、libtiff），而预编译 wheel 常缺失架构支持或网格数据；conda-forge 提供完整二进制包（含 proj 及转换网格），推荐优先使用 conda 安装。
直接用 pip install pyproj 就能装，但 macOS（尤其是 Apple Silicon）和某些 Linux 环境下大概率会失败或功能不全——不是命令不对，而是底层依赖没处理好。
为什么 pip install pyproj 在很多机器上会报错
pyproj 本质是 PROJ 库的 Python 封装，需要编译链接系统级的 C 依赖（如 libproj、libtiff、libcurl）。pip 默认尝试安装预编译 wheel，但：
- macOS 上多数 wheel 不含 Apple Silicon 支持，会退回到源码编译，而系统缺少
proj头文件和库 - Linux（尤其 CentOS/RHEL）缺
libproj-dev或proj-devel包，pip编译时找不到proj.h - Windows 上虽常成功，但若没装 Visual Studio Build Tools，也可能卡在 numpy 构建阶段
- pyproj 3.0+ 的 wheel 默认不含转换网格（如
us_noaa、egm96_15），导致transform精度下降或报Grid missing错误
conda 安装才是更稳的选择（尤其 macOS / 科学计算环境）
conda-forge 提供了完整打包的二进制包，PROJ 及其所有依赖（包括网格数据）都已预置并动态链接好。执行以下三步即可：
conda config --prepend channels conda-forge conda config --set channel_priority strict conda create -n geoenv python=3.10 pyproj
然后激活环境：conda activate geoenv。此时运行 from pyproj import CRS; CRS.from_epsg(4326) 能立刻成功，且 Transformer.from_crs(..., always_xy=True) 也默认支持高精度网格。
非要用 pip？必须加两个关键参数
如果你被限制只能用 pip（比如 CI 环境或公司镜像策略），请按顺序执行：
- 先确保系统 PROJ 已就位：macOS 运行
brew install proj；Ubuntu/Debian 执行sudo apt-get install libproj-dev；CentOS/RHEL 用sudo yum install proj-devel - 设环境变量让 pip 找到它：
export PROJ_DIR=$(brew --prefix proj)（macOS）或export PROJ_DIR=/usr（Linux） - 强制从 conda-forge 源拉 wheel（含网格）：
pip install --find-links https://conda.anaconda.org/conda-forge/pyproj --no-deps --force-reinstall pyproj - 最后补依赖：
pip install numpy pandas（不要用--only-binary，否则可能丢 PROJ 功能）
验证安装是否真正可用
别只测 import pyproj——那只是加载成功。真正要跑通的是带真实坐标转换的最小闭环：
from pyproj import Transformer
trans = Transformer.from_crs("EPSG:4326", "EPSG:32650", always_xy=True)
x, y = trans.transform(120.3055, 31.4775)
print(round(x), round(y)) # 应输出类似 378200 3482000
如果报 pyproj.exceptions.ProjError: grid shift missing，说明网格没加载，得回退到 conda 方案；如果报 ImportError: libproj.so.25: cannot open shared object file，说明系统 PROJ 版本不匹配，pip 安装时没绑定对动态库。
