---
title: "如何安装 Django"
version: 2.2
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/2.2/topics/install/
canonical: https://djangodocs.dev/zh-hans/2.2/topics/install/
---
# 如何安装 Django

本文档将帮助您使用 Django。

## 安装 Python

Django 是一个 Python Web 框架。参见 [我应该使用哪个版本的 Python 来配合 Django?](/zh-hans/2.2/faq/install/#faq-python-version-support) 获取更多细节。

可以通过 <https://www.python.org/downloads/> 或者操作系统的包管理工具获取最新版本的 Python。

> **基于 Jython 的 Django**
>
> [Jython](http://www.jython.org/) （一个针对 Java 平台的 Python 实现）和 Python 3 不兼容，所以Django 2.0 及以上的版本无法在 Jython 上运行。

> **Windows 上的 Python**
>
> 如果您刚刚开始学习 Django 并且使用 Windows，查看 [如何在 Windows 上安装 Django](/zh-hans/2.2/howto/windows/)  可能对你有帮助。

## 安装 Apache 和 `mod_wsgi`

如果您只是想试验 Django，请跳到下一部分；Django 包含一个可用于测试的轻量级 Web 服务器，因此在准备好在生产环境中部署 Django 之前，您不需要设置 Apache。

如果要在生产站点上使用 Django，请将 [Apache](https://httpd.apache.org/) 与 [mod\_wsgi](https://modwsgi.readthedocs.io/en/develop/) 一起使用。 mod\_wsgi 能以两种模式运行：嵌入模式或守护进程模式。在嵌入模式下，mod\_wsgi 类似于 mod\_perl —— 它在 Apache 中嵌入 Python，并在服务器启动时将 Python 代码加载到内存中。代码在 Apache 进程的整个生命周期中都保留在内存中，与其他服务器相比，这可以显着提高性能。在守护进程模式下，mod\_wsgi 会生成一个处理请求的独立守护进程。守护进程可以作为与 Web 服务器不同的用户运行，可能会提高安全性。可以在不重新启动整个 Apache Web 服务器的情况下重新启动守护进程，从而可以更加无缝地刷新代码库。请参阅 mod\_wsgi 文档以确定适合您的设置的模式。确保你在安装了 Apache 并且启用了 mod\_wsgi 模块。 Django 将在任何支持 mod\_wsgi 的 Apache 版本上工作。

若已安装 mod\_wsgi 模块，请查看 [Django 如何利用 mod\_wsgi 工作](/zh-hans/2.2/howto/deployment/wsgi/modwsgi/) 了解如何配置。

如果由于某种原因你不能使用 mod\_wsgi，请不要担心： Django 支持许多其他部署选项。一个是 [uWSGI](/zh-hans/2.2/howto/deployment/wsgi/uwsgi/) ；它和 [nginx](https://nginx.org/) 配合使用很好。此外，Django 遵循 WSGI 规范（ [**PEP 3333**](https://peps.python.org/pep-3333/) ），允许它在各种服务器平台上运行。

## 运行你的数据库

如果你打算使用 Django 的数据库 API 功能，则需要确保数据库服务器正在运行。Django 支持很多不同的数据库服务器，并且正式支持 [PostgreSQL](https://www.postgresql.org/)， [MySQL](https://www.mysql.com/)，[Oracle](https://www.oracle.com/) 和 [SQLite](https://www.sqlite.org/) 。

如果你正在开发一个简单的项目或其它不打算在生产环境中部署的东西，SQLite 通常是最简单的选择，因为它不需要运行一个独立的服务器。但是，SQLite 与其他数据库有许多不同之处，因此如果你正在开展大量工作，建议使用你计划在生产中使用的数据库进行开发。

除了官方支持的数据库，还有 [第三方提供的后端](/zh-hans/2.2/ref/databases/#third-party-notes) 允许你在 Django 中使用其他数据库。

除了数据库后端，你还要确保安装了 Python 数据库绑定。

- 如果你正在使用 PostgreSQL，你需要 [psycopg2](http://initd.org/psycopg/) 包。相关详细信息请参阅 [PostgreSQL 笔记](/zh-hans/2.2/ref/databases/#postgresql-notes)。
- 如果你正在使用 MySQL，则需要一个像 `mysqlclient` 这样的 [DB API driver](/zh-hans/2.2/ref/databases/#mysql-db-api-drivers) 。相关详细信息请参阅 [针对 MySQL 后端的笔记](/zh-hans/2.2/ref/databases/#mysql-notes) 。
- 如果你正在使用 SQLite，则可能需要阅读 [SQLite 后端笔记](/zh-hans/2.2/ref/databases/#sqlite-notes) 。
- 如果你正在使用 Oracle，则需要 [cx\_Oracle](https://oracle.github.io/python-cx_Oracle/) 的副本，但请阅读 [针对 Oracle 后端的笔记](/zh-hans/2.2/ref/databases/#oracle-notes) 以获取有关 Oracle 和 `cx_Oracle` 支持的版本的详细信息。
- 如果你使用的是非官方的第三方后端，请参阅提供的文档以了解任何其他要求。

如果您打算使用 Django 的 `manage.py migrate` 命令为您的模型自动创建数据库表（在首次安装 Django 并创建项目之后），您需要确保 Django 有权在您正在使用的数据库中创建和更改表；如果你打算手动创建这些表，你可以只需授予 Django `SELECT`，`INSERT`，`UPDATE` 和 `DELETE` 权限。创建具有这些权限的数据库用户后，您要在项目的配置文件中指定详细信息，请参阅 [`DATABASES`](/zh-hans/2.2/ref/settings/#std-setting-DATABASES) 以获取详细信息。

如果你正在使用 Django 的 [测试框架](/zh-hans/2.2/topics/testing/) 来测试数据库查询，Django 将需要创建测试数据库的权限。

## 安装 Django 源码

安装过程可能会有些许差异，这取决于你是否在安装一个发行版——某个特定的版本，下载最新的正式发布包，或获取最新的开发版本。

这很简单，不管你选哪种。

### 通过 `pip` 安装正式发布版本

以下是安装 Django 的推荐方式。

1. 安装 [pip](https://pip.pypa.io/)。最简单的方式是使用 [独立 pip 安装器](https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py)。若你的系统早已安装 `pip`，你可能需要更新它，因为它可能过期了。如果它过期了，你会知道的，因为过期的用不了。
2. 瞅一眼 [virtualenv](https://virtualenv.pypa.io/) 和 [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/)。这些工具能提供分离的 Python 环境，这将比直接在系统中安装包更实用。它们也允许在未经系统管理员许可的情况下安装包。[贡献指南](/zh-hans/2.2/intro/contributing/) 简单介绍了如何创建 virtualenv。
3. 在你已创建并激活一个虚拟环境后，输入以下命令：

   ```console
   $ pip install Django
   ```

   *Windows*

   ```doscon
   ...\> pip install Django
   ```

### 安装特定发行版

查阅 [发布说明](/zh-hans/2.2/misc/distributions/) 了解你的平台/发行版是否提供了官方的 Django 包或安装器。发行版系统所提供的包通常会自动安装依赖，且易于升级；然而，这些包几乎不包含最新版的 Django。

### 安装开发版本

> **跟踪 Django 开发**
>
> 如果你决定使用 Django 的最新开发版，你需要关注 [开发版时间轴](https://code.djangoproject.com/timeline) 和 [即将到来的新特性的发布说明](/zh-hans/2.2/releases/#development-release-notes)。这将保证你能获取所有新特性和最新的代码。（对于稳定发布版，所有必要的修改都在发布说明中记录。）

如果你希望偶尔能获取最新的补丁和改进，遵循以下说明：

1. 确保你已安装了 [Git](https://git-scm.com/)，这样你就可以从 shell 运行对应命令。（在 shell 中输入 `git help` 测试是否安装。）
2. 像这样检出 Django 的主开发分支：

   ```console
   $ git clone https://github.com/django/django.git
   ```

   *Windows*

   ```doscon
   ...\> git clone https://github.com/django/django.git
   ```

   这会在当前目录创建一个 `django` 目录。
3. 确保 Python 解释器可以加载 Django 代码。最方便的方式是使用 [virtualenv](https://virtualenv.pypa.io/)，[virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/) 和 [pip](https://pip.pypa.io/)。[贡献指南](/zh-hans/2.2/intro/contributing/) 简略介绍了如何创建 virtualenv。
4. 在配置并激活 virtualenv 后，运行以下命令：

   ```console
   $ pip install -e django/
   ```

   *Windows*

   ```doscon
   ...\> pip install -e django\
   ```

   这会让 Django 的代码可导入，使得 `django-admin` 命令行工具可用。换句话说，大事可为。

当你要更新本地 Django 源码副本时，在 `django` 目录中运行 `git pull` 命令。当你这样做时，Git 或自动拉取更新。