一般来说，GeoDjango 安装需要：
\n以下各节提供了每项要求的细节和安装说明。此外，还提供了以下平台的具体说明：
\n\n\n因为 GeoDjango 是包含在 Django 中的，所以请参考 Django 的 安装说明 来详细了解如何安装。
\n目前支持的空间数据库包括 PostgreSQL（带有 PostGIS）、MySQL、Oracle 和 SQLite（带有 SpatiaLite）。
\n\nGeoDjango 安装所需的地理空间库取决于所使用的空间数据库。 下面列出了每个支持的数据库后端的库需求、支持的版本和任何注释。
\n数据库 | \n库依赖项 | \n支持的版本 | \n注意 | \n
|---|---|---|---|
PostgreSQL | \nGEOS, GDAL, PROJ, PostGIS | \n13+ | \n需要 PostGIS。 | \n
MySQL | \nGEOS, GDAL | \n8.0.11+ | \n功能受限。 | \n
Oracle | \nGEOS, GDAL | \n19+ | \n不支持 XE。 | \n
SQLite | \nGEOS, GDAL, PROJ, SpatiaLite | \n3.31.0+ | \n需要 SpatiaLite 4.3+ | \n
关于 PostgreSQL／PostGIS／GEOS／GDAL的可能组合，也请参见 OSGeo Wiki 上的 `这个比较矩阵`__ 。
\nDATABASES 配置Link to this heading#django.contrib.gis 到 INSTALLED_APPSLink to this heading#和其他 Django contrib 应用一样，你只需要在配置中的 INSTALLED_APPS 中添加 django.contrib.gis。这是为了让 gis 模板能够被定位 —— 如果不这样做，那么诸如地理管理或 KML 网站地图等功能将无法正常运行。
如果你在这里找不到解决问题的方法，那就参与社区吧！你可以：
\n在 `GeoDjango`__ 论坛上提出您的问题。
如果你认为有 bug，请在 `Django trac`__ 上提交一个工单。 确保提供完整的问题描述，使用的版本，并指定组件为 “GIS”。
到目前为止，安装 GeoDjango 时最常见的问题是无法找到外部共享库（例如 GEOS 和 GDAL）。[1] 通常情况下，造成这个问题的原因是操作系统不知道从源码建立的库的安装目录。
\n一般情况下，库路径可以通过设置环境变量按每个用户来设置，也可以为整个系统配置库路径。
\nLD_LIBRARY_PATH 环境变量Link to this heading#用户可以设置这个环境变量来自定义他们想要使用的库路径。从源代码构建的软件的典型库目录是 /usr/local/lib。因此，/usr/local/lib 需要包含在 LD_LIBRARY_PATH 变量中。例如，用户可以将以下内容放入他们的 bash 配置文件中：
export LD_LIBRARY_PATH=/usr/local/lib\n在 GNU/Linux 系统上，通常在 /etc/ld.so.conf 中有一个文件，该文件可以包含来自另一个目录的文件中的额外路径，例如 /etc/ld.so.conf.d。作为 root 用户，在 ld.so.conf 中的新行中添加自定义库路径（例如 /usr/local/lib）。这是如何做的一个示例：
$ sudo echo /usr/local/lib >> /etc/ld.so.conf\n$ sudo ldconfig\n对于 OpenSolaris 用户，可以使用 crle 实用程序来修改系统库路径。运行 crle 不带选项可以查看当前配置，使用 crle -l 来设置新的库路径。在修改系统库路径时要非常小心：
# crle -l $OLD_PATH:/usr/local/lib\nbinutilsLink to this heading#GeoDjango 使用 find_library 函数（来自 ctypes.util Python 模块）来发现库。 find_library 例程使用一个叫做 objdump 的程序（binutils 包的一部分）来验证 GNU／Linux 系统的共享库。 因此，如果 binutils 没有安装在你的 Linux 系统上，那么 Python 的 ctypes 可能无法找到你的库，即使你的库路径设置正确，并且地理空间库建立得很完美。
在 Debian 和 Ubuntu 系统上，可以使用以下命令安装 binutils 软件包：
$ sudo apt-get install binutils\n类似地，在 Red Hat 和 CentOS 系统上：
\n$ sudo yum install binutils\n由于 macOS 的打包系统多种多样，用户在安装 GeoDjango 时有几种不同的选择。这些选择是：
\nPostgres.app （最简易且推荐）
这一节还包含了从 Python 软件基金会提供的软件包中安装升级版 Python 的说明，但是，这不是必须的。
\n虽然 macOS 安装了 Python，但用户可以使用 Python 软件基金会提供的 `框架安装程序`__ 。 使用安装程序的一个好处是，macOS 的 Python 将保持 “原始” 状态，供操作系统内部使用。
\n\nPostgres.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\n你可以在终端提示符下输入 which psql 检查路径是否设置正确。
`Homebrew`__ 提供了从源码中构建二进制文件和软件包的 “菜谱”。它为运行 macOS 的 Macintosh 电脑提供了 GeoDjango 的先决条件。因为 Homebrew 仍然从源码构建软件，所以需要使用 Xcode 。
\n摘要：
\n$ brew install postgresql\n$ brew install postgis\n$ brew install gdal\n$ brew install libgeoip\n`Kurt Schwehr`__ 很慷慨地为 `Fink`__ 包系统的用户创建了 GeoDjango 包。根据你想使用的 Python 版本，可以使用不同的包（从 django-gis 开始）。
`MacPorts`__ 可以用来在运行 macOS 的计算机上安装 GeoDjango 的先决条件。 因为 MacPorts 仍然从源码构建软件，所以需要使用 Xcode 。
\n摘要：
\n$ sudo port install postgresql13-server\n$ sudo port install geos\n$ sudo port install proj6\n$ sudo port install postgis3\n$ sudo port install gdal\n$ sudo port install libgeoip\n为了在 Windows 上安装 GeoDjango，请依次完成以下章节。在本教程中，我们将安装每个应用程序的 64 位版本。
\n安装一个 64 位版本的 Python。更多信息请参见 安装 Python。
\n从 `EnterpriseDB`__ 网站下载最新的 `PostgreSQL 15.x 安装程序`__。下载完成后，运行安装程序，按照屏幕上的提示进行操作，除非您知道更改选项的后果，否则保持默认选项。
\n\n当安装程序完成时，它会询问 “在退出时启动 Stack Builder?” —— 请确定这个问题，因为需要安装 PostGIS。
\n\n在 Stack Builder 中（在安装程序外运行，选择 ），从下拉菜单中选择 ，然后点击下一步。展开 菜单树，并选择 。
\n点击下一步后，您将被提示确认所选的包和“下载目录”。再次点击下一步，这将下载 PostGIS，并要求您点击下一步开始 PostGIS 安装程序。在安装过程中，包括四个 Yes/No 对话框，所有四个的默认选项都是 "No"。
\nOSGeo4W installer 可以帮助安装 GeoDjango 所需的 PROJ、GDAL 和 GEOS 库。首先，下载 OSGeo4W installer 并运行它。选择 然后点击下一步。在 'Select Packages' 列表中，确保选择了 GDAL。如果默认启用了其他任何软件包，它们对于 GeoDjango 是不需要的，可以安全地取消选中。点击下一步并接受许可协议后，软件包将被自动下载和安装，然后您可以退出安装程序。
\n为了使用 GeoDjango，你需要将 OSGeo4W 目录添加到 Windows 系统的 Path 中，并创建 GDAL_DATA 和 PROJ_LIB 环境变量。 下面这组命令可以用 cmd.exe 执行，用于设置。设置完成后，请重新启动设备，以便识别新的环境变量。
set OSGEO4W_ROOT=C:\\OSGeo4W\nset GDAL_DATA=%OSGEO4W_ROOT%\\apps\\gdal\\share\\gdal\nset PROJ_LIB=%OSGEO4W_ROOT%\\share\\proj\nset PATH=%PATH%;%OSGEO4W_ROOT%\\bin\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"\nreg ADD "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"\npsycopg Python 模块提供了 Python 和 PostgreSQL 数据库之间的接口。您可以在 Python 虚拟环境中使用 pip 安装 psycopg：
...\\> py -m pip install psycopg\n脚注
\n\n