Python 环境搭建
版本选择
对于一个新创建的项目，理论上应使用较新的 Python 版本（毕竟你以后可能都不会想升级版本了）。
NoneBot2 目前要求 Python 版本 >= 3.10（PyPI 上写得清清楚楚），而本文档将以 Python 3.12 为标准。 为什么不是最新的 3.14？因为 3.12 的插件兼容性最稳， 而且文档是照着 3.12 写的，你装个 3.14 出问题了别来找我（
一句话总结：装 3.12，别问为什么。
关于 Windows 7
醒醒，Windows 7 已经不行了。
Python 3.9 是最后一个支持 Windows 7 的版本，而 NoneBot2 要求 3.10+， 这两个要求之间隔着一道不可逾越的鸿沟 建议直接换系统。 网上确实有第三方提供的能在 Windows 7 上运行的 Python 3.9 安装包（比如 这个）， 但版本卡死在 3.9 意味着与 NoneBot2 无缘，所以…… 要不咱换个系统吧（bushi）。
配置解释器
Windows
我们强烈建议直接从 Python 官网 下载安装包。
因为 Python 官网在国外，访问速度与下载速度都会受到较大影响，需要你自己克服一下（
吐槽 - 关于微软商店版 Python
winget install Python.Python.3.12上面这条命令会安装微软商店版的 Python。
如果没有安装微软商店版 Python，实际使用中可能会遇到执行 python.exe 时跳转到微软商店的情况 Fxxk List 喜加一。
微软商店版 Python 的存储目录与官网版本区别很大，即便通常情况下几乎没有查看 Python 存储目录的需求，部分程序也会因为无法适应这种特殊环境而运作异常。
安装官网版时，记得勾选 "Add python.exe to PATH"，否则之后在终端里敲 python 只会得到一句冷冰冰的 'python' 不是内部或外部命令。
Linux
通常来说，Linux 系的系统都自带了 Python（前提是有系统组件依赖 Python），无非版本的新与旧。
以 Ubuntu 为例，各主流 Ubuntu 版本自带的 Python 版本关系如下所示：
- 20.04 LTS：Python 3.8
- 22.04 LTS：Python 3.10
- 24.04 LTS：Python 3.12
- 26.04 LTS：Python 3.14
NoneBot2 要求 Python >= 3.10，因此如果你使用的系统自带的 Python 满足要求，就不用单独安装 Python 了。 不过 22.04 自带的 3.10 只能算"能跑"，本文以 3.12 为标准， 系统自带的版本不是 3.12 的话，还是建议自己装一个。
而假如系统自带的 Python 版本较低或不自带 Python，那么你可以尝试在系统的软件包管理器中搜索有没有新版 Python。
sudo apt search "python3\."
sudo apt install python3.12 python-is-python3sudo pacman -S pythonsudo dnf install python版本太新的烦恼 新啊，很新啊
部分 Linux 发行版默认只提供尽可能新的 Python 版本（如 Fedora, Arch, Termux （这货的兼容性需要一篇文章专门描述） 等）， 这种时候某些兼容不好的传统派 Python 库就有可能会在安装过程中创飞你。
小心 CentOS
和前面那些不同，目前 CentOS 的稳定版已经处在濒死状态（CentOS 8 已于 2021 年 12 月 31 日结束支持，CentOS 7 也已在 2024 年 6 月 30 日结束支持）。其软件仓库亦非常老旧，使用近几年的新东西也很麻烦。 如果条件允许还是换成 Debian 或者 Ubuntu 吧（最好尽可能新，别整个 16, 18 版的 Ubuntu 之类的，也别在服务器上折腾 Arch（本文默认读者折腾不起））。
你要用 CentOS Stream 那当我没说（假如你需要管理多个 Python 版本，我们推荐使用 uv——uv python install 3.12 一条命令就能把 Python 本体装好，具体用法见虚拟环境 & 包管理器（uv）。
从源代码安装只能是最后的退路
尽管源码包的预设基本能保证安装可用的 Python，但你通常不应该用默认编译配置（因为会缺 SSL 等相关模块导致网络访问寄掉等一系列问题），而且很多发行版都会针对自身特性打一堆补丁。
macOS
你可以在 Python 官网 下载安装包安装，当然你也可以选择通过 Homebrew 安装：
brew install python@3.12测试 Python 安装
- 打开命令提示符（Windows）或终端（Linux/macOS）。
- 输入
python --version命令。 - 如果 Python 安装成功，将会显示当前安装的 Python 版本号（本文标准为 3.12.x）。
