安装依赖

Windows

使用 Poetry

如果你已经安装了 Poetry，你可以跳过以下安装步骤。

1. 安装 Poetry：

   方式一

   提示

   pip 在国内的下载速度比较慢，你可以通过以下命令设置 pip 的镜像源来加快连接速度（建议）：

   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

   1. 打开终端，执行以下命令来安装 pipx：

      pip install --user pipx
      python -m pipx ensurepath

   2. 重启终端，并输入以下命令：

      pipx install poetry

   3. 安装完成后，你可以通过运行 poetry --version 来确认 Poetry 是否有效安装。

   方式二

   1. 打开 Powershell，并执行以下指令来安装 Poetry：

      (Invoke-WebRequest -Uri "https://install.python-poetry.org" -UseBasicParsing).Content | py -
      信息

      若你使用了 Microsoft Store 或 pyenv-windows 安装 Python，请将 py 替换为 python。

      注意

      安装 Poetry 前请务必检查系统环境变量中是否存在多个 Python Executable Path（Python 可执行路径）并及时清除，否则安装 Poetry 后可能会出现 Python 环境混乱导致无法正常加载依赖的情况。

   2. 安装完成后，请将以下目录添加到 PATH 环境变量，请善用搜索引擎寻找更改 PATH 的方法：

      %APPDATA%\Python\Scripts
      信息

      在添加到 PATH 之后，你通常需要重启终端，甚至整个电脑才能使其生效。

      你可以通过运行 poetry --version 来确认 Poetry 是否有效安装。

2. 在安装完 Poetry 后，请执行以下指令：

   提示

   Poetry 在国内的下载速度比较慢，你可以通过以下命令设置 Poetry 的镜像源来加快连接速度（建议）：

   poetry source add --priority=default mirrors https://pypi.tuna.tsinghua.edu.cn/simple/

   poetry install

使用 pip

如果你不想使用 Poetry，你可以使用 pip 来安装依赖：

提示

pip 在国内的下载速度比较慢，你可以通过以下命令设置 pip 的镜像源来加快连接速度（建议）：

python -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

pip install -r requirements.txt

信息

在安装依赖时若出现报错，请转到疑难解答

Linux

使用 Poetry

如果你已经安装了 Poetry，你可以跳过以下安装步骤。

1. 安装 Poetry：

   方式一

   提示

   pip 在国内的下载速度比较慢，你可以通过以下命令设置 pip 的镜像源来加快连接速度（建议）：

   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

   1. 打开终端，执行以下命令来安装 pipx：

      pip install --user pipx
      python3 -m pipx ensurepath

   2. 重启终端，并输入以下命令：

      信息

      在此之前，你可能需要先安装 python3-venv：

      sudo apt-get install python3-venv

      安装的命令会因为系统的不同而发生改变。

      pipx install poetry

   3. 安装完成后，你可以通过运行 poetry --version 来确认 Poetry 是否有效安装。

   方式二

   1. 打开终端，并执行以下指令来安装 Poetry：

      curl -sSL "https://install.python-poetry.org" | python3 -
      注意

      安装 Poetry 前请务必检查系统环境变量中是否存在多个 Python Executable Path（Python 可执行路径）并及时清除，否则安装 Poetry 后可能会出现 Python 环境混乱导致无法正常加载依赖的情况。

   2. 安装完成后，请将以下目录添加到 PATH 环境变量，请善用搜索引擎寻找修改 PATH 的方法：

      $HOME/.local/bin
      信息

      在添加到 PATH 之后，你通常需要重启终端，甚至整个电脑才能使其生效。

      你可以通过 poetry --version 确认安装是否有效。

2. 在安装完 Poetry 后，请执行以下指令：

   提示

   Poetry 在国内的下载速度比较慢，你可以通过以下命令设置 Poetry 的镜像源来加快连接速度（建议）：

   poetry source add --priority=default mirrors https://pypi.tuna.tsinghua.edu.cn/simple/

   poetry install

使用 pip

如果你不想使用 Poetry，你可以使用 pip 来安装依赖：

提示

pip 在国内的下载速度比较慢，你可以通过以下命令设置 pip 的镜像源来加快连接速度（建议）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

pip install -r requirements.txt

信息

在安装依赖时若出现报错，请转到疑难解答