一般来说，GeoDjango 安装需要：
以下各节提供了每项要求的细节和安装说明。此外，还提供了以下平台的具体说明：
使用源码
因为 GeoDjango 利用了最新的开源地理空间软件技术，所以需要最新版本的库。如果你的平台没有二进制包，可能需要从源码安装。当从源码编译库时，请严格按照说明进行，尤其是当你是初学者时。
PostgreSQL (with PostGIS), MySQL, Oracle, and SQLite (with SpatiaLite) are the spatial databases currently supported.
备注
推荐使用 PostGIS，因为它是最成熟、功能最丰富的开源空间数据库。
GeoDjango 安装所需的地理空间库取决于所使用的空间数据库。 下面列出了每个支持的数据库后端的库需求、支持的版本和任何注释。
| 数据库 | 库依赖项 | 支持的版本 | 注意 |
|---|---|---|---|
| PostgreSQL | GEOS, GDAL, PROJ, PostGIS | 12+ | 需要 PostGIS。 |
| MySQL | GEOS, GDAL | 8+ | 功能受限。 |
| Oracle | GEOS, GDAL | 19+ | 不支持 XE。 |
| SQLite | GEOS, GDAL, PROJ, SpatiaLite | 3.21.0+ | 需要 SpatiaLite 4.3+ |
关于 PostgreSQL／PostGIS／GEOS／GDAL的可能组合，也请参见 OSGeo Wiki 上的 `这个比较矩阵`__ 。
django.contrib.gis 到 INSTALLED_APPS¶和其他 Django contrib 应用一样，你只需要在配置中的 INSTALLED_APPS 中添加 django.contrib.gis。这是为了让 gis 模板能够被定位 —— 如果不这样做，那么诸如地理管理或 KML 网站地图等功能将无法正常运行。
如果你在这里找不到解决问题的方法，那就参与社区吧！你可以：
#django-geo IRC channel on Libera.Chat. Please be patient and
polite -- while you may not get an immediate response, someone will attempt
to answer your question as soon as they see it.到目前为止，安装 GeoDjango 时最常见的问题是无法找到外部共享库（例如 GEOS 和 GDAL）。[1] 通常情况下，造成这个问题的原因是操作系统不知道从源码建立的库的安装目录。
一般情况下，库路径可以通过设置环境变量按每个用户来设置，也可以为整个系统配置库路径。
LD_LIBRARY_PATH 环境变量¶A user may set this environment variable to customize the library paths
they want to use. The typical library directory for software
built from source is /usr/local/lib. Thus, /usr/local/lib needs
to be included in the LD_LIBRARY_PATH variable. For example, the user
could place the following in their bash profile:
export LD_LIBRARY_PATH=/usr/local/lib
On GNU/Linux systems, there is typically a file in /etc/ld.so.conf, which may include
additional paths from files in another directory, such as /etc/ld.so.conf.d.
As the root user, add the custom library path (like /usr/local/lib) on a
new line in ld.so.conf. This is one example of how to do so:
$ sudo echo /usr/local/lib >> /etc/ld.so.conf
$ sudo ldconfig
For OpenSolaris users, the system library path may be modified using the
crle utility. Run crle with no options to see the current configuration
and use crle -l to set with the new library path. Be very careful when
modifying the system library path:
# crle -l $OLD_PATH:/usr/local/lib
binutils¶GeoDjango 使用 find_library 函数（来自 ctypes.util Python 模块）来发现库。 find_library 例程使用一个叫做 objdump 的程序（binutils 包的一部分）来验证 GNU／Linux 系统的共享库。 因此，如果 binutils 没有安装在你的 Linux 系统上，那么 Python 的 ctypes 可能无法找到你的库，即使你的库路径设置正确，并且地理空间库建立得很完美。
The binutils package may be installed on Debian and Ubuntu systems using the
following command:
$ sudo apt-get install binutils
Similarly, on Red Hat and CentOS systems:
$ sudo yum install binutils
由于 macOS 的打包系统多种多样，用户在安装 GeoDjango 时有几种不同的选择。这些选择是：
这一节还包含了从 Python 软件基金会提供的软件包中安装升级版 Python 的说明，但是，这不是必须的。
虽然 macOS 安装了 Python，但用户可以使用 Python 软件基金会提供的 `框架安装程序`__ 。 使用安装程序的一个好处是，macOS 的 Python 将保持 “原始” 状态，供操作系统内部使用。
备注
You will need to modify the PATH environment variable in your
.profile file so that the new version of Python is used when
python is entered at the command-line:
export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH
Postgres.app 是一个独立的 PostgreSQL 服务，包括 PostGIS 扩展。你还需要安装 gdal 和 libgeoip，并安装 Homebrew。
安装 Postgres.app 后，在你的 .bash_profile 中添加以下内容，这样你就可以在命令行中运行软件包的程序。用你安装的 Postgres.app 中的 PostgreSQL 版本替换 X.Y：
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin
你可以在终端提示符下输入 which psql 检查路径是否设置正确。
`Homebrew`__ 提供了从源码中构建二进制文件和软件包的 “菜谱”。它为运行 macOS 的 Macintosh 电脑提供了 GeoDjango 的先决条件。因为 Homebrew 仍然从源码构建软件，所以需要使用 Xcode 。
Summary:
$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip
`Kurt Schwehr`__ 很慷慨地为 `Fink`__ 包系统的用户创建了 GeoDjango 包。根据你想使用的 Python 版本，可以使用不同的包（从 django-gis 开始）。
`MacPorts`__ 可以用来在运行 macOS 的计算机上安装 GeoDjango 的先决条件。 因为 MacPorts 仍然从源码构建软件，所以需要使用 Xcode 。
Summary:
$ sudo port install postgresql13-server
$ sudo port install geos
$ sudo port install proj6
$ sudo port install postgis3
$ sudo port install gdal
$ sudo port install libgeoip
备注
You will also have to modify the PATH in your .profile so
that the MacPorts programs are accessible from the command-line:
export PATH=/opt/local/bin:/opt/local/lib/postgresql13/bin
In addition, add the DYLD_FALLBACK_LIBRARY_PATH setting so that
the libraries can be found by Python:
export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql13
为了在 Windows 上安装 GeoDjango，请依次完成以下章节。在本教程中，我们将安装每个应用程序的 64 位版本。
Download the latest `PostgreSQL 15.x installer`__ from the `EnterpriseDB`__ website. After downloading, run the installer, follow the on-screen directions, and keep the default options unless you know the consequences of changing them.
备注
PostgreSQL 安装程序会创建一个新的 postgres 数据库超级用户，你会被提示设置一次密码 —— 一定要记住它！
当安装程序完成时，它会询问 “在退出时启动 Stack Builder?” —— 请确定这个问题，因为需要安装 PostGIS。
备注
If installed successfully, the PostgreSQL server will run in the background
each time the system as started as a Windows service. A
start menu group will created and contains
shortcuts for the Application Stack Builder (ASB) as well as the
'SQL Shell', which will launch a psql command window.
From within the Stack Builder (to run outside of the installer, ), select from the drop down menu and click next. Expand the menu tree and select .
After clicking next, you will be prompted to confirm the selected package and "Download directory". Click next again, this will download PostGIS and you will be asked to click next to begin the PostGIS installer. Select the default options during install. The install process includes four Yes/No dialog boxes, the default option for all four is "No".
The OSGeo4W installer helps to install the PROJ, GDAL, and GEOS libraries required by GeoDjango. First, download the OSGeo4W installer, and run it. Select and click next. In the 'Select Packages' list, ensure that GDAL is selected. If any other packages are enabled by default, they are not required by GeoDjango and may be unchecked safely. After clicking next and accepting the license agreements, the packages will be automatically downloaded and installed, after which you may exit the installer.
为了使用 GeoDjango，你需要将 OSGeo4W 目录添加到 Windows 系统的 Path 中，并创建 GDAL_DATA 和 PROJ_LIB 环境变量。 下面这组命令可以用 cmd.exe 执行，用于设置。设置完成后，请重新启动设备，以便识别新的环境变量。
set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%OSGEO4W_ROOT%\bin
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"
备注
执行这些命令需要管理员权限。要做到这一点，请以管理员身份运行命令提示符，并输入上述命令。你需要注销并重新登录，设置才会生效。
备注
如果你自定义了 OSGeo4W 的安装目录，那么你需要相应地修改 OSGEO4W_ROOT 变量。
Install Django on your system. It is recommended that you create a virtual environment for each project you create.
The psycopg Python module provides the interface between Python and the
PostgreSQL database. psycopg can be installed via pip within your Python
virtual environment:
...\> py -m pip install psycopg
脚注
| [1] | GeoDjango 使用 ctypes.util 中的 find_library() 例程来查找共享库。 |
9月 22, 2023