---
title: "安装 SpatiaLite"
version: 4.1
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/4.1/ref/contrib/gis/install/spatialite/
canonical: https://djangodocs.dev/zh-hans/4.1/ref/contrib/gis/install/spatialite/
---
# 安装 SpatiaLite

[SpatiaLite](https://www.gaia-gis.it/fossil/libspatialite/index) 为 SQLite 增加了空间支持，使其成为一个全功能的空间数据库。

首先，检查是否可以从系统包或二进制文件中安装 SpatiaLite。

For example, on Debian-based distributions that package SpatiaLite 4.3+, try to
install the `libsqlite3-mod-spatialite` package. For older releases install
`spatialite-bin`.

对于 macOS，请按照 [下方的说明](#spatialite-macos)。

对于 Windows，你可以在 [Gaia-SINS](https://www.gaia-gis.it/gaia-sins/) 主页上找到二进制文件。

在任何情况下，你都应该能够 [从源码安装](#spatialite-source)。

## 从源码安装

[GEOS and PROJ](/zh-hans/4.1/ref/contrib/gis/install/geolibs/) should be installed
prior to building SpatiaLite.

### SQLite

首先检查 SQLite 是否使用 [R\*Tree 模块](https://www.sqlite.org/rtree.html) 编译。运行 sqlite3 命令行界面，输入以下查询：

```
sqlite> CREATE VIRTUAL TABLE testrtree USING rtree(id,minX,maxX,minY,maxY);
```

如果你获得一个错误，你将不得不从源码重新编译 SQLite。否则，请跳过本节。

要从源码安装，请从 [SQLite 下载页面](https://www.sqlite.org/download.html) 下载最新的合并源码档案，并解压：

```
$ wget https://www.sqlite.org/YYYY/sqlite-amalgamation-XXX0000.zip
$ unzip sqlite-amalgamation-XXX0000.zip
$ cd sqlite-amalgamation-XXX0000
```

接下来，运行 `configure` 脚本 —— 不过 `CFLAGS` 环境变量需要自定义，以便 SQLite 知道如何构建 R\*Tree 模块：

```
$ CFLAGS="-DSQLITE_ENABLE_RTREE=1" ./configure
$ make
$ sudo make install
$ cd ..
```

### SpatiaLite 库（`libspatialite`）

从 [下载页面](https://www.gaia-gis.it/gaia-sins/libspatialite-sources/) 获取最新的 SpatiaLite 库源捆绑包：

```
$ wget https://www.gaia-gis.it/gaia-sins/libspatialite-sources/libspatialite-X.Y.Z.tar.gz
$ tar xaf libspatialite-X.Y.Z.tar.gz
$ cd libspatialite-X.Y.Z
$ ./configure
$ make
$ sudo make install
```

> **Note**
>
> 对于从源头构建的 macOS 用户来说，SpatiaLite 库 *和* 工具需要配置其 `target` ：
>
> ```
> $ ./configure --target=macosx
> ```

## macOS 特定说明

To install the SpatiaLite library and tools, macOS users can use [Homebrew](https://brew.sh/).

### Homebrew

[Homebrew](https://brew.sh/) 代表你处理所有与 SpatiaLite 相关的软件包，包括 SQLite、SpatiaLite、PROJ 和 GEOS。按以下方式安装它们：

```
$ brew update
$ brew install spatialite-tools
$ brew install gdal
```

最后，为了让 GeoDjango 能够找到 SpatiaLite 库，在你的 `settings.py` 中添加以下内容：

```
SPATIALITE_LIBRARY_PATH='/usr/local/lib/mod_spatialite.dylib'
```