Cartopy在Windows下的安装指南

如果你需要在Windows系统上安装Cartopy，可能会遇到一些依赖库和编译问题。别担心，跟着下面的步骤走，你就能顺利安装。

一、安装前的准备工作

在安装Cartopy之前，你需要先准备好运行环境。

1. 安装Python

Cartopy是一个Python库，所以首先需要安装Python：

访问Python官网（python.org）
下载Python 3.7或更高版本的Windows安装包
安装时务必勾选“Add Python to PATH”选项
建议使用Python 3.8或3.9版本，兼容性更好

2. 安装必要的依赖库

Cartopy依赖几个重要的地理信息处理库，需要先安装这些库：

方法一：使用预编译的wheel包（推荐给新手）

打开命令提示符（按Win+R，输入cmd，按回车）
依次安装以下库：

pip install numpy
pip install shapely
pip install pyshp
pip install pyproj
pip install geopy

方法二：使用conda安装（更简单） 如果你安装了Anaconda或Miniconda，可以这样安装：

conda install -c conda-forge cartopy

conda会自动处理所有依赖关系，这是最简单的安装方式。

二、Cartopy安装步骤

方法A：使用pIP直接安装（适合大多数用户）

升级pip工具 打开命令提示符，输入：
```
python -m pip install --upgrade pip
```
安装Cartopy 输入以下命令：
```
pip install cartopy
```
验证安装 安装完成后，验证是否成功：
```
python -c "import cartopy; print(cartopy.__version__)"
```
如果显示版本号，说明安装成功。

方法B：手动安装（解决常见问题）

如果直接安装失败，可以尝试手动安装：

下载预编译的wheel文件
- 访问Python扩展包的非官方Windows二进制文件网站
- 搜索“cartopy”
- 下载对应你Python版本和系统位数的.whl文件
例如：cartopy-0.20.2-cp39-cp39-win_amd64.whl
- cp39表示Python 3.9
- win_amd64表示64位Windows
本地安装wheel文件 下载后，在文件所在目录打开命令提示符，输入：
```
pip install 文件名.whl
```
将“文件名.whl”替换为你下载的实际文件名。

三、常见问题解决

问题1：提示“Microsoft Visual C++ 14.0 is required”

解决方案：

下载安装Visual Studio Build Tools
或者直接安装Microsoft Visual C++可再发行组件包

问题2：PROJ相关错误

解决方案：

先安装pyproj：
```
pip install pyproj
```
如果还有问题，尝试：
```
conda install -c conda-forge proj
```

问题3：Shapely安装失败

解决方案：

访问Gohlke的Python扩展包页面
下载对应版本的Shapely预编译包
使用pip本地安装

四、安装验证和测试

安装完成后，运行一个简单的测试程序：

import matplotlib.pyplot as plt
import cartopy.crs as ccrs

# 创建地图
fig = plt.figure(figsize=(10, 5))
ax = plt.axes(projection=ccrs.PlateCarree())
ax.coastlines()

# 添加网格线
ax.gridlines(draw_labels=True)

# 显示地图
plt.title('Cartopy安装测试 - 世界地图')
plt.show()

如果能看到世界地图，说明Cartopy安装成功并可以正常使用。

五、优化建议

使用虚拟环境 建议为地理数据处理创建独立的虚拟环境：
```
python -m venv geo_env
geo_env\Scripts\activate
pip install cartopy
```
安装Jupyter Notebook 为了方便测试和开发，可以安装Jupyter：
```
pip install jupyter notebook
```
安装完整的数据包 Cartopy需要一些基础地图数据：
```
pip install cartopy[plotting]
```

六、快速入门示例

安装成功后，你可以尝试这个简单的例子：

import cartopy.feature as cfeature
import matplotlib.pyplot as plt
import cartopy.crs as ccrs

# 创建中国区域地图
fig = plt.figure(figsize=(12, 8))
ax = fig.add_subplot(1, 1, 1, projection=ccrs.PlateCarree())

# 设置地图范围（中国区域）
ax.set_extent([70, 140, 15, 55], crs=ccrs.PlateCarree())

# 添加地理特征
ax.add_feature(cfeature.LAND)
ax.add_feature(cfeature.OCEAN)
ax.add_feature(cfeature.COASTLINE)
ax.add_feature(cfeature.BORDERS, linestyle=':')
ax.add_feature(cfeature.LAKES, alpha=0.5)
ax.add_feature(cfeature.RIVERS)

# 添加省份边界
ax.add_feature(cfeature.STATES, linestyle='--', edgecolor='gray')

plt.title('中国地图示例')
plt.show()

注意事项

网络问题：如果下载速度慢，可以使用国内镜像源：
```
pip install cartopy -i https://pypi.tuna.tsinghua.edu.cn/simple
```
权限问题：如果遇到权限错误，可以：
- 以管理员身份运行命令提示符
- 或者使用--user参数：pip install --user cartopy
版本兼容：确保所有库的版本兼容，特别是：
- NumPy版本不要太新
- Matplotlib建议使用3.3.x或3.4.x版本