最近更新
在2025.06.05日，GDAL發布預告：新版本將適配pipeline和向量讀寫功能。
?
直到2025.06.25日，最新的版本才算發行出來。
?
有朋友催我趕緊更新教程，我上次更新是3月份的時候了，恰好是GDAL上一個版本出來的時間。
前言
很多大氣，地理，環境，生態，遙感，城市空間規劃等專業的朋友，在各種終端嘗試
pip install GDAL指令時，都會遇到各種各樣奇怪的報錯，無論如何都安不上。說實話這條路走不通，不怪你。
因為GDAL不是標準的python庫，不能直接用pip指令，進行管理操作。
實際證明，這樣走不通的，請你放棄幻想。跟著這個教程一步一步的操作，你大概率是可以成功的。我會盡可能的詳細，一步一步，足夠緩慢，足夠讓每個第一次安裝的朋友都能夠明白。
感謝北京師范大學地理學院的朋友提供的幫助，我將把這個方法詳細記錄，希望可以幫助到更多朋友。
個人電腦配置說明
OS：Windows 11 Enterprise（MacOS和Linux的朋友，建議拉到文末，采用Conda指令安裝）
Version：24H2 （有的朋友是Win10版本，或者22H2，都行）
Compile Architecture：AMD64（劃重點，待會兒要用）
IDE：Cursor 1.2.2（PyCharm，Conda，VSCode等，都是可以的）
Terminal：Cmd（這是系統自帶的，不需要下載，每個人都有）
Broswer：Chrome Version 138.0.7204.97 (Official Build) (64-bit)?(能打開網頁就行)
Python：Version 3.13.5?64-bit (CPython ) （自行下載好，站內有Python下載教程）
NetWork：🔮，🪜，我默認各位打得開Github，站內有教程。
這個方法主要是wheel格式文件（.whl）手動下載，手動輸入指令安裝，我第一次只用了10分鐘就完成了，但是在此之前，兩天都沒能安上。
具體操作
第一步：確定Python版本和編譯架構
這一步很重要，GDAL包不是隨便找個版本就能用，因為不同版本的GDAL包只能適配特定版本的Python，所以必須知道Python的版本。這樣可以尋找到，對應版本且合適能用，的GDAL包。
就像生物疫苗，一種疫苗，它只能特異性克制一種病毒，別的都不行。有病的時候，不是隨便打一針奇怪疫苗，病就能好，這好不了。
如果下載的GDAL包，與，Python和編譯架構對不上，就會報錯，這樣絕對安不上！
按住：Win + R（鍵盤最下面，那個帶浮標的）
?
?跳出彈窗如下，然后手動輸入：cmd，然后點OK
在自己的Terminal（終端）輸入：
python得到如下的結果：我的Python是3.13.5的版本，各位朋友可以看看自己的。不是非要和我一樣才行，你的3.10或者3.11，或者其他版本，都是可以的。
MSC v.1943 64 bit (AMD64): 這是編譯器的信息，表示這個Python解釋器是用Microsoft Visual C++ (MSC) 編譯器的1943版本編譯的，支持64位（AMD64）架構。
支持AMD64的意思，就是和ARM區分，和32位區分，GDAL版本眾多，要選擇符合當前電腦的。
有的人是32位的，有的人是ARM架構的，反正你得先知道自己電腦的版本。
?
第二步：去下載安裝文件
最新GDAL下載網址：https://github.com/cgohlke/geospatial-wheels/releases
我默認你是可以打開Github類的網頁，有疑問或打不開，可以在站內查詢攻略
很可能沒有展示完畢，再點一下，全部展開！
根據自己電腦的python版本，編譯架構，下載相適配的版本。
于我而言，我該下載：gdal-3.11.1-cp313-cp313-win_amd64.whl
點擊下載適合自己電腦和Python版本的GDAL文件，保存到電腦桌面上。（Github文件下載速度太慢的朋友，考慮站內搜索加速辦法，我默認你會）
我現在回答一下，有的朋友問：我的Python是3.9或3.8的老版本，這里沒有啊，怎么辦？
答案：在這個網頁往下繼續翻閱，資源在以前的更新中，一個一個點開Assets，總會有你需要的版本。
還有朋友問：最近出新版本的GDAL包了，我該如何更新？
答案：能不更新就不更新，除非你的版本已經不能用了。必須采取新版本的新功能，滿足我當前的工程需要！此時你才需要更新，平時沒有那么多功能用得上。
更新的套路就是：卸載舊版本后，確保能夠適配的新版本情況下，下載并安裝。
（如何卸載：文章后面會講，卸載倒是很easy）
第三步：找到正確的安裝路徑
我們需要找到Python軟件中名為：“Scripts”的文件夾路徑。很多朋友找不到這個文件夾在哪，其他攻略也沒寫，我來“好為人師”一次，就當獻丑了。
和剛才一樣，按下win+R，打開cmd終端
首先輸入：（輸入完按回車）
python緊接著輸入：（輸入完按回車）
import sys最后輸入：（輸入完按回車）
print(sys.path)列表中的倒數第二個將是你的安裝路徑：
第四步：在安裝路徑放入文件
按住win + E ，在文件夾中，根據名稱，一步一步找到它的位置，速度快只需要30妙。（我個人會采用這個方法，我比較傳統）
當然還有一種簡便方法，就是打開記事本，編輯一下路徑，然后粘貼到位。（好朋友提供的辦法）
在桌面上，將下載好的GDAL包，拖動到指定的📁內。
完成后，那兒也不要去，就在當前📁，在路徑框內輸入CMD。
像我這樣操作，就好了，很簡單。
第五步：輸入正確的安裝指令
按下回車??的效果是這樣的，你需要看到類似的。
最后只需要簡單的輸入指令：
pip install gdal-3.11.1-cp313-cp313-win_amd64.whl?當然具體版本，視每個人的電腦情況而定，你下了什么文件，你就把文件名替換上去即可。
pip install "復制你下載到桌面的文件名，后綴.whl，也帶上"展示安裝好的截圖：
得到的結果如下：成功安裝好了新版本，這也說明，我的電腦和python版本可以是適配3.11.1的GDAL包。??警告warning，是可以忽略的，我頂著警告??，照樣正常使用。而第一次安裝成功的朋友，只會有一個返回說明:
Successfully installed GDAL-XXXXX具體的，XXXXX，視每個人下載的具體版本而定，但我想祝賀你，你已經成功安裝好了GDAL包！
你將會在地圖解析，衛星遙感和城市規劃中大展拳腳！
其他說明
驗證是否能用
我們可以在IDE中新建一個python的demo文件，粘貼一下代碼，看看效果。
如果有路徑報錯，在最后面有三個教程可以看看，解決路徑問題。
from osgeo import gdal# 打開一個 GeoTIFF 格式的柵格數據文件
dataset = gdal.Open('example.tif')?
?如果沒有報錯，那就忽略警告，繼續正常使用。
?
在Cursor這個IDE的Terminal處輸入指令：（能查看過去所有安裝過的包和版本）
pip list?
卸載GDAL的操作
在Cursor這個IDE的Terminal處輸入指令：（能自動檢測已有的GDAL包和版本）
pip uninstall gdal
其他推薦：
2025！使用Conda安裝GDAL（一行指令就行！）-CSDN博客
GDAL簡介與安裝-CSDN博客
【轉載】在Python中安裝GDAL（最簡單，最詳細圖文教程）_gdal下載whl-CSDN博客
GDAL庫簡介及函數說明-CSDN博客
GDAL — GDAL documentation
GitHub - OSGeo/gdal: GDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.
)
