Wagtail 是一款基于 Django 框架的 Python 语言下的开源内容管理系统，因此要使用 Wagtail 首先要配置好其需要的 Python 环境。

安装 Python

在本教程中给出在 Windows 下安装 Python的教程，和 Debian 系统下的安装说明。

Windows 安装 Python

下载 Python 软件包

为了快速下载，我们使用 Python Release 的国内镜像下载，进入镜像：https://mirrors.huaweicloud.com/python/

选择合适的 Python 版本， 你可以选择任意支持的版本，本文以 python 3.13.7 为例。

  • 如果你的系统是 64 位系统则下载软件包 python-3.13.7-amd64.exe
  • 如果你的系统是 64 位系统则下载软件包 python-3.13.7.exe

安装 Python 软件包

双击软件包安装 Python

注意：一定要勾选 “Add python.exe to PATH”

选择安装方式：

推荐选择 "Install Now"，它会使用默认配置完成安装 如需自定义安装，点击 "Customize installation"，然后一步一步完成安装

具体的安装细节在此就不赘述。

Debian 安装 Python

推荐使用系统版本

Debian 系统中默认已经安装了 Python 软件包，一般情况下使用系统中自带的 Python 版本已经足够。

源码编译安装 Python

在 Debian 系统允许安装多个版本的 Python 软件包，如果你要使用其他的 Python 版本可以自行安装，推荐使用源码编译安装需要版本的 Python。

1、安装编译安装需要使用的软件包：

sudo apt update
sudo apt install -y \
    build-essential \
    zlib1g-dev \
    libncurses5-dev \
    libgdbm-dev \
    libnss3-dev \
    libssl-dev \
    libreadline-dev \
    libffi-dev \
    libsqlite3-dev \
    libbz2-dev \
    liblzma-dev \
    wget

软件包 wget 是下载软件包的工具

2、下载 Python 源码包，在这里以安装 Python 3.13.7 为例：

wget https://mirrors.huaweicloud.com/python/3.13.7/Python-3.13.7.tgz

3、解压下载的 Python 源码包，并转到解压的目录

tar -xf Python-3.9.18.tgz
cd Python-3.9.18

4、运行配置命令，生成配置文件

./configure \
    --enable-optimizations \
    --prefix=/usr/local/python3.13 \
    --with-ensurepip=install

命令解释说明：

  • --enable-optimizations：用于启用性能优化
  • --prefix=/usr/local/python3.13：用于指定安装目录
  • --with-ensurepip=install：同时安装 pip

5、编译源代码为适用于系统的二进制文件（-j 后面的数字为 CPU 核心数，加速编译，可通过 nproc 查看）

make -j $(nproc)

解释说明：

  • -j：用于指定编译使用的 CPU 核心数
  • $(nproc)：用于获取 shell 中的 CPU 核心数变量 nproc 的值

6、安装 python（使用 altinstall 而非 install，避免替换系统默认的 python3 命令）

sudo make altinstall clean

解释说明：

  • altinstall：避免替换系统默认的 python3 命令
  • clean：安装后清楚生成的中间文件

7、安装完成后，可执行的 Python 文件位于：/usr/local/python3.13/bin，该目录默认不在 PATH 目录中，可以添加到 PATH 中：

编辑 ~/.bashrc 文件，在文件的末尾添加如下代码：

vi ~/.bashrc

#添加自定义目录到 PATH
export PATH="$PATH:/usr/local/python3.13/bin"