这是Python版本3.14.0 alpha 0

.. image:: https://github.com/python/cpython/actions/workflows/build.yml/badge.svg?branch=main&event=push :alt: GitHub Actions上CPython构建状态 :target: https://github.com/python/cpython/actions

.. image:: https://dev.azure.com/python/cpython/_apis/build/status/Azure%20Pipelines%20CI?branchName=main :alt: Azure DevOps上CPython构建状态 :target: https://dev.azure.com/python/cpython/_build/latest?definitionId=4&branchName=main

.. image:: https://img.shields.io/badge/discourse-join_chat-brightgreen.svg :alt: Python Discourse聊天 :target: https://discuss.python.org/

有关更多版权和许可信息，请参阅本文件末尾。

.. contents::

一般信息

网站：https://www.python.org
源代码：https://github.com/python/cpython
问题追踪：https://github.com/python/cpython/issues
文档：https://docs.python.org
开发者指南：https://devguide.python.org/

为CPython做贡献

有关为CPython开发做贡献的更完整说明，请参阅开发者指南_。

.. _开发者指南: https://devguide.python.org/

使用Python

可安装的Python套件以及有关使用Python的信息可在 python.org_上获取。

.. _python.org: https://www.python.org/

构建说明

在Unix、Linux、BSD、macOS和Cygwin上：

./configure
make
make test
sudo make install

这将安装Python为python3。

您可以向configure脚本传递许多选项；运行./configure --help 以了解更多信息。在macOS大小写不敏感的文件系统和Cygwin上，可执行文件称为python.exe；在其他地方它只是python。

构建完整的Python安装需要使用各种额外的第三方库，这取决于您的构建平台和配置选项。并非所有标准库模块都可在所有平台上构建或使用。有关各种Linux发行版和macOS当前详细的依赖信息，请参阅开发者指南中的 安装依赖 <https://devguide.python.org/getting-started/setup-building.html#build-dependencies> 部分。

在macOS上，有与macOS框架和通用构建相关的额外配置和构建选项。请参阅Mac/README.rst <https://github.com/python/cpython/blob/main/Mac/README.rst>_。

在Windows上，请参阅PCbuild/readme.txt <https://github.com/python/cpython/blob/main/PCbuild/readme.txt>_。

要构建Windows安装程序，请参阅Tools/msi/README.txt <https://github.com/python/cpython/blob/main/Tools/msi/README.txt>_。

如果您愿意，可以创建一个子目录并从那里调用configure。例如：

mkdir debug
cd debug
../configure --with-pydebug
make
make test

（如果您同时在顶级目录构建，这将失败。您应该先在顶级目录执行make clean。）

要获得Python的优化构建，在运行make之前执行 configure --enable-optimizations。这将设置默认make目标以启用配置文件引导优化（PGO），并可能在某些平台上自动启用链接时间优化（LTO）。有关更多详细信息，请参阅下面的部分。

配置文件引导优化 ^^^^^^^^^^^^^^^^^^^^^^^^^^^

PGO利用了GCC或Clang编译器的最新版本。如果使用，无论是通过configure --enable-optimizations还是手动运行 make profile-opt（不考虑配置标志），优化的构建过程将执行以下步骤：

清理整个Python目录中可能由先前编译产生的临时文件。

构建一个带有指令的解释器版本，为每种类型使用适当的编译器标志。请注意，这只是一个中间步骤。这一步产生的二进制文件不适合实际工作负载，因为它包含嵌入的分析指令。

在构建了带指令的解释器之后，Makefile将运行一个训练工作负载。这对于分析解释器的执行是必要的。还要注意，在这一步可能出现的任何输出，包括stdout和stderr，都会被抑制。最后一步是使用从经过插桩的解释器收集到的信息来构建实际的解释器。最终结果将是一个经过优化的Python二进制文件，适用于分发或生产环境安装。

链接时优化 ^^^^^^^^^^

通过配置的"--with-lto"标志启用。LTO利用了最新编译器工具链在构建最终可执行文件或共享库时能够跨越原本任意的.o文件边界进行优化的能力，以获得额外的性能提升。

新特性

我们在《Python 3.14新特性》文档中提供了变更的全面概述。如需更详细的变更日志，请阅读Misc/NEWS，但完整的变更记录只能从提交历史中获取。

如果您想安装多个版本的Python，请参阅下面题为"安装多个版本"的部分。

文档

Python 3.14的文档可在线获取，每日更新。

也可以下载多种格式以便更快访问。文档可下载HTML、PDF和reStructuredText格式；后者主要面向文档作者、翻译人员和有特殊格式要求的人。

有关构建Python文档的信息，请参阅Doc/README.rst。

测试

要测试解释器，在顶级目录中输入"make test"。测试集会产生一些输出。您通常可以忽略由于无法导入可选功能而跳过测试的消息。如果出现失败测试的消息或产生回溯或核心转储，则说明出现了问题。

默认情况下，测试会被阻止过度使用磁盘空间和内存等资源。要启用这些测试，请运行"make buildbottest"。

如果有任何测试失败，您可以在详细模式下重新运行失败的测试。例如，如果test_os和test_gdb失败，您可以运行：

make test TESTOPTS="-v test_os test_gdb"

如果问题持续存在，并且似乎是Python的问题而不是您的环境问题，您可以提交错误报告，并包含该命令的相关输出以展示问题。

有关运行测试的更多信息，请参阅《运行和编写测试》。

安装多个版本

在Unix和Mac系统上，如果您打算使用相同的安装前缀（配置脚本的--prefix参数）安装多个Python版本，您必须注意不要让主要的python可执行文件被不同版本的安装覆盖。使用"make altinstall"安装的所有文件和目录都包含主版本和次版本号，因此可以并存。"make install"还会创建${prefix}/bin/python3，它指向${prefix}/bin/python3.X。如果您打算使用相同的前缀安装多个版本，您必须决定哪个版本（如果有）是您的"主要"版本。使用"make install"安装该版本。使用"make altinstall"安装所有其他版本。

例如，如果您想安装Python 2.7、3.6和3.14，其中3.14是主要版本，您应该在3.14构建目录中执行"make install"，在其他版本中执行"make altinstall"。