NoneBot2 快速入门指南：从零开始构建你的聊天机器人-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00912/article/details/148465496

NoneBot2 快速入门指南：从零开始构建你的聊天机器人

nonebot2 跨平台 Python 异步聊天机器人框架 / Asynchronous multi-platform chatbot framework written in Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot2

前言

NoneBot2 是一个现代化、跨平台的 Python 聊天机器人框架，基于异步 I/O 设计，支持多种聊天平台接入。本文将带你快速了解如何搭建一个基础的 NoneBot2 项目，让你在几分钟内就能运行起自己的第一个聊天机器人。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

Python 版本 ≥ 3.9（推荐使用 Python 3.10 或更高版本）
建议使用虚拟环境（virtualenv 或 conda）隔离项目依赖

如果你之前安装过 NoneBot 的早期版本（v1），请先执行以下命令卸载：

pip uninstall nonebot

安装脚手架工具

NoneBot2 提供了名为 nb-cli 的命令行工具，它能帮助我们快速创建和管理项目。安装步骤如下：

首先安装 pipx（Python 应用包管理工具）：
```
python -m pip install --user pipx
python -m pipx ensurepath
```
安装完成后可能需要重新打开终端使环境变量生效。
通过 pipx 安装 nb-cli：
```
pipx install nb-cli
```

验证安装是否成功：

nb --version

创建新项目

使用脚手架创建项目非常简单，只需执行：

nb create

创建过程中会询问一些配置选项：

项目模板选择：
- bootstrap：适合初学者，内置插件商店支持
- simple：更简洁的基础模板，适合自定义开发
项目名称：输入你的机器人项目名称，如 my-first-bot
驱动器选择：推荐选择 FastAPI，它是 NoneBot2 默认的高性能 Web 框架
适配器选择：初学者可以先选择 Console 适配器在终端测试
依赖安装：建议选择 "Yes" 自动安装所需依赖
虚拟环境：强烈建议为每个项目创建独立的虚拟环境
内置插件：可以选择 echo 插件作为测试用

项目结构解析

创建完成后，你的项目目录结构大致如下：

my-first-bot/
├── bot.py                # 机器人入口文件
├── pyproject.toml        # 项目配置和依赖声明
├── .env                  # 环境变量配置文件
└── nonebot_plugin_echo/  # 示例插件目录