环境配置

安装Python

相关信息

需要Python3.8-3.10版本，可通过python -V或python3 -V查看版本号。

该部分教程可以参考Well404的NoneBot2.0.0RC 全平台保姆级新手教学中关于安装python的教程。

Ubuntu

如果是20+的版本，系统会自带python3.8或3.10版本，可以直接使用。

如果是更低的版本，请自行安装python3.8-3.10版本。

Ubuntu可能没有自带pip命令，需要运行apt install python3-pip进行安装

Debian系统和Ubuntu系统同理。

CentOS

建议更换Ubuntu，否则请自行编译安装Python3.8-3.10版本，耗子尾汁

CentOS在后续也可能有更多的问题，因此强烈不建议您使用CentOS 如果你执意使用，后续出现的额外问题，例如playwright缺依赖，请自行搜索解决。

Windows

可以去Python官网下载安装包，安装时记得勾选Add Python 3.x to PATH。

也可以在Microsoft Store(微软商店)下载安装Python3.8-3.10。

检查安装是否成功

安装完后，通过命令python -V或python3 -V查看版本号来确认是否安装成功。

如果python -V显示的版本不是3.8+而python3 -V是的话，请将本教程后续涉及到的python改为python3。

安装Poetry

包管理器

我们需要用到Poetry作为Python环境和包管理器。 更详细具体安装方法请参考Poetry官方文档

使用官方安装脚本来安装

官方的安装脚本可能会比较慢，如果不能接受等待过长时间，可以使用其他的安装方法。

Linux, macOS

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

Windows

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

使用pipx来安装

如果没有pipx，需要先安装pipx

pip install pipx
或
pip3 install pipx

然后运行一下命令来安装Poetry，如果仍提示没有pipx，请尝试重启刷新一下命令行

pipx install poetry

使用pip来安装

在终端输入以下命令安装Poetry

pip install poetry
或
pip3 install poetry

检查安装是否成功

运行以下命令查看版本已确认安装成功

poetry -V

安装git

About Git

git用于下载和更新Bot代码，可以先用git --version查看是否已安装git，如已安装，可跳过。

Linux发行版可以用其对应的包管理器安装，比如Ubuntu用apt install git，CentOS用yum install git。

Windows请自行搜索安装方法，下载安装包来安装。

安装ffmpeg

About ffmpeg

ffmpeg在本Bot主要用于发送语音消息，如果您不需要发送语音消息的功能，可以不安装。

Ubuntu系统可以直接使用apt install ffmpeg来安装。

其他系统请自行搜索安装教程，记得添加到环境变量中。

使用ffmpeg -version来检查是否安装成功。