Python 安装指南

本指南面向刚接触 Python 编程语言并希望在系统中安装它的用户。它将帮助您设置运行 EvoX 所需的 Python 环境。

提示： EvoX 是用 Python 编写的，因此您需要在系统中安装 Python。 EvoX 支持 Python 3.10 及以上版本，我们建议使用 最新版本 的 Python。

安装 Python 解释器

前往下载 Python 并下载最新版本的 Python。

注意： 请确保在安装过程中勾选“Add Python to PATH”（将 Python 添加到 PATH）选项。

不同的 Linux 发行版有不同的 Python 安装方式。这取决于您发行版的包管理器。以下是一些示例：

uv 是一个极快的 Python 包和项目管理器，支持 Windows、Linux 和 MacOS。我们建议使用 uv 来安装 Python 解释器以及管理 Python 环境。详细的安装指南可以在 uv 安装指南中找到。

使用 irm 下载脚本并用 iex 执行：

$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

更改执行策略允许运行来自互联网的脚本。

通过在 URL 中包含版本号来请求特定版本：

$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.6.16/install.ps1 | iex"

使用 curl 下载脚本并用 sh 执行：

$ curl -LsSf https://astral.sh/uv/install.sh | sh

如果您的系统没有 curl，可以使用 wget：

$ wget -qO- https://astral.sh/uv/install.sh | sh

通过在 URL 中包含版本号来请求特定版本：

$ curl -LsSf https://astral.sh/uv/0.6.16/install.sh | sh

pip 是 Python 的包管理器。venv 是 Python 内置的用于创建虚拟环境的工具。虚拟环境是一个独立的目录，其中包含特定版本的 Python 安装以及若干附加包。这对于分别管理不同项目的依赖关系非常有用。

要在终端中创建虚拟环境，请运行以下命令：

$ python -m venv <env_path> # 通常 <env_path> 是项目中的 `.venv` 目录

这将创建一个名为 <env_path> 的新目录，其中包含 Python 解释器和标准库的副本。要激活虚拟环境，请运行以下命令：

$ source <env_path>/bin/activate # Bash
$ source <env_path>/bin/activate.fish # Fish
$ <env_path>\Scripts\activate # Windows

这将更改您的 shell 提示符，以表明您现在正在虚拟环境中工作。要停用虚拟环境，请运行以下命令：

$ deactivate

这将使您返回到系统的默认 Python 解释器及其安装的所有库。

激活虚拟环境后，您可以使用 pip 将包安装到虚拟环境中。例如，要安装最新版本的 numpy，请运行以下命令：

$ pip install numpy

这将把 numpy 安装到虚拟环境中，而不会影响系统范围的 Python 安装。要安装特定版本的 numpy，请运行以下命令：

$ pip install numpy==1.23.4

这将把 numpy 的 1.23.4 版本安装到虚拟环境中。要列出虚拟环境中安装的所有包，请运行以下命令：

$ pip list

这将显示虚拟环境中安装的所有包及其版本的列表。要卸载包，请运行以下命令：

$ pip uninstall numpy

这将从虚拟环境中卸载 numpy。要升级包，请运行以下命令：

$ pip install --upgrade numpy

这将把虚拟环境中的 numpy 升级到最新版本。

uv 不仅可以管理 Python 版本，还可以管理 Python 环境。要创建一个新的 Python 环境，请运行以下命令：

$ uv venv --python <python_version> # 例如 3.10, 3.11, ...

这将创建一个名为 .venv 的新目录，其中包含 Python 解释器和标准库的副本。要激活虚拟环境，请运行以下命令：

$ source <env_path>/bin/activate # Bash
$ source <env_path>/bin/activate.fish # Fish
$ <env_path>\Scripts\activate # Windows

激活虚拟环境后，您可以使用 uv pip 将包安装到虚拟环境中。例如，要安装最新版本的 numpy，请运行以下命令：

$ uv pip install numpy