NoneBot2 项目手动创建指南：从零开始构建聊天机器人-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00474/article/details/148465598

NoneBot2 项目手动创建指南：从零开始构建聊天机器人

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

前言

NoneBot2 是一个基于 Python 的异步机器人框架，它提供了丰富的功能和灵活的扩展性。虽然官方推荐使用 nb-cli 工具快速创建项目，但了解如何手动创建项目对于深入理解框架工作原理非常有帮助。本文将详细介绍如何从零开始手动创建一个 NoneBot2 项目的最小实例。

准备工作

环境配置

在开始项目创建前，我们需要确保开发环境准备就绪：

Python 环境：建议使用 Python 3.8 或更高版本
虚拟环境（推荐）：使用虚拟环境可以隔离项目依赖

创建虚拟环境的命令如下：

python -m venv .venv --prompt nonebot2

启动虚拟环境：

Windows: .venv\Scripts\activate
Linux/macOS: source .venv/bin/activate

依赖安装

NoneBot2 的核心功能需要安装以下依赖：

pip install 'nonebot2[fastapi]'

此外，我们还需要安装适配器，这里以控制台适配器为例：

pip install nonebot-adapter-console

项目结构规划

一个最小化的 NoneBot2 项目至少需要包含以下文件：

项目文件夹/
├── .env          # 配置文件
└── bot.py        # 入口文件

配置文件详解

配置文件(.env)用于存储机器人的运行配置，采用 dotenv 格式。以下是一个基础配置示例：

HOST=0.0.0.0       # 监听地址
PORT=8080          # 监听端口
COMMAND_START=["/"] # 命令前缀
COMMAND_SEP=["."]   # 命令分隔符

配置项说明：

HOST 和 PORT 决定了机器人服务的网络接口
COMMAND_START 定义了触发机器人命令的前缀字符
COMMAND_SEP 定义了命令参数的分隔符

入口文件解析

入口文件(bot.py)是机器人的启动入口，负责初始化框架和加载组件。以下是典型实现：

import nonebot
from nonebot.adapters.console import Adapter as ConsoleAdapter

# 初始化NoneBot核心
nonebot.init()

# 获取驱动器实例并注册适配器
driver = nonebot.get_driver()
driver.register_adapter(ConsoleAdapter)

# 加载插件
nonebot.load_builtin_plugins("echo")  # 加载内置echo插件

if __name__ == "__main__":
    nonebot.run()

代码解析：