shoucandanghehe · Oct 13, 2026 · Oct 13, 2026
diff --git a/.github/workflows/codecov.yml b/.github/workflows/codecov.yml
@@ -25,7 +25,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest, macos-latest]
         env: [pydantic-v1, pydantic-v2]
     env:

diff --git a/README.md b/README.md
@@ -21,7 +21,7 @@ _✨ 跨平台 Python 异步机器人框架 ✨_
   <a href="https://pypi.python.org/pypi/nonebot2">
     <img src="https://img.shields.io/pypi/v/nonebot2?logo=python&logoColor=edb641" alt="pypi">
   </a>
-  <img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&logoColor=edb641" alt="python">
+  <img src="https://img.shields.io/badge/python-3.11+-blue?logo=python&logoColor=edb641" alt="python">
   <a href="https://github.com/psf/black">
     <img src="https://img.shields.io/badge/code%20style-black-000000.svg?logo=python&logoColor=edb641" alt="black">
   </a>

diff --git a/nonebot/compat.py b/nonebot/compat.py
@@ -19,14 +19,15 @@
     Generic,
     Literal,
     Protocol,
+    Self,
     TypeAlias,
     TypeVar,
     cast,
     get_args,
     get_origin,
     overload,
 )
-from typing_extensions import ParamSpec, Self, is_typeddict
+from typing_extensions import ParamSpec, is_typeddict
 
 from pydantic import VERSION, BaseModel
 

diff --git a/nonebot/dependencies/__init__.py b/nonebot/dependencies/__init__.py
@@ -15,7 +15,7 @@
 from typing import Any, Generic, TypeVar, cast
 
 import anyio
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.compat import FieldInfo, ModelField, PydanticUndefined
 from nonebot.exception import SkippedException

diff --git a/nonebot/drivers/none.py b/nonebot/drivers/none.py
@@ -16,7 +16,7 @@
 
 import anyio
 from anyio.abc import TaskGroup
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.config import Config, Env
 from nonebot.consts import WINDOWS

diff --git a/nonebot/internal/adapter/bot.py b/nonebot/internal/adapter/bot.py
@@ -3,7 +3,7 @@
 from typing import TYPE_CHECKING, Any, ClassVar, Protocol
 
 import anyio
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.config import Config
 from nonebot.exception import MockApiException
@@ -121,7 +121,7 @@
            ):
                async with anyio.create_task_group() as tg:
                    for hook in self._calling_api_hook:
                        tg.start_soon(hook, self, api, data)

        if not skip_calling_api:
            try:
@@ -170,7 +170,7 @@
            ):
                async with anyio.create_task_group() as tg:
                    for hook in self._called_api_hook:
                        tg.start_soon(hook, self, exception, api, data, result)

        if exception:
            raise exception

diff --git a/nonebot/internal/adapter/message.py b/nonebot/internal/adapter/message.py
@@ -5,12 +5,12 @@
 from typing import (  # noqa: UP035
     Any,
     Generic,
+    Self,
     SupportsIndex,
     Type,
     TypeVar,
     overload,
 )
-from typing_extensions import Self
 
 from nonebot.compat import custom_validation, type_validate_python
 
@@ -107,7 +107,7 @@
 
     def __init__(
         self,
-        message: str | None | Iterable[TMS] | TMS = None,
+        message: str | Iterable[TMS] | TMS | None = None,
     ):
         super().__init__()
         if message is None:
@@ -122,7 +122,7 @@
            self.extend(self._construct(message))  # pragma: no cover

    @classmethod
    def template(cls, format_string: str | TM) -> MessageTemplate[Self]:
        """创建消息模板。

        用法和 `str.format` 大致相同，支持以 `Message` 对象作为消息模板并输出消息对象。

diff --git a/nonebot/internal/driver/abstract.py b/nonebot/internal/driver/abstract.py
@@ -2,12 +2,11 @@
 from collections.abc import AsyncGenerator
 from contextlib import AsyncExitStack, asynccontextmanager
 from types import TracebackType
-from typing import TYPE_CHECKING, Any, ClassVar, TypeAlias
-from typing_extensions import Self
+from typing import TYPE_CHECKING, Any, ClassVar, Self, TypeAlias
 
 from anyio import CancelScope, create_task_group
 from anyio.abc import TaskGroup
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.config import Config, Env
 from nonebot.dependencies import Dependent

diff --git a/nonebot/internal/driver/model.py b/nonebot/internal/driver/model.py
@@ -16,11 +16,11 @@
 class Timeout:
     """Request 超时配置。"""
 
-    total: float | None | UnsetType = UNSET
-    connect: float | None | UnsetType = UNSET
-    read: float | None | UnsetType = UNSET
-    close: float | None | UnsetType = UNSET
-    ping: float | None | UnsetType = UNSET
+    total: float | UnsetType | None = UNSET
+    connect: float | UnsetType | None = UNSET
+    read: float | UnsetType | None = UNSET
+    close: float | UnsetType | None = UNSET
+    ping: float | UnsetType | None = UNSET
 
 
 DEFAULT_TIMEOUT = Timeout(total=None, connect=5.0, read=30.0, close=10.0, ping=20.0)
@@ -31,15 +31,15 @@ class Timeout:
 SimpleQuery: TypeAlias = str | int | float
 QueryVariable: TypeAlias = SimpleQuery | list[SimpleQuery]
 QueryTypes: TypeAlias = (
-    None | str | Mapping[str, QueryVariable] | list[tuple[str, SimpleQuery]]
+    str | Mapping[str, QueryVariable] | list[tuple[str, SimpleQuery]] | None
 )
 
 HeaderTypes: TypeAlias = (
-    None | CIMultiDict[str] | dict[str, str] | list[tuple[str, str]]
+    CIMultiDict[str] | dict[str, str] | list[tuple[str, str]] | None
 )
 
 CookieTypes: TypeAlias = (
-    "None | Cookies | CookieJar | dict[str, str] | list[tuple[str, str]]"
+    "Cookies | CookieJar | dict[str, str] | list[tuple[str, str]] | None"
 )
 
 ContentTypes: TypeAlias = str | bytes | None

diff --git a/nonebot/internal/matcher/matcher.py b/nonebot/internal/matcher/matcher.py
@@ -13,14 +13,14 @@
     Callable,
     ClassVar,
     NoReturn,
+    Self,
     Type,
     TypeVar,
     overload,
 )
-from typing_extensions import Self
 import warnings
 
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.consts import (
     ARG_KEY,

diff --git a/nonebot/internal/params.py b/nonebot/internal/params.py
@@ -7,14 +7,15 @@
     Annotated,
     Any,
     Literal,
+    Self,
     cast,
     get_args,
     get_origin,
 )
-from typing_extensions import Self, override
+from typing_extensions import override
 
 import anyio
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 from pydantic.fields import FieldInfo as PydanticFieldInfo
 
 from nonebot.compat import FieldInfo, ModelField, PydanticUndefined
@@ -97,7 +98,8 @@ async def handler(
     return DependsInner(dependency, use_cache=use_cache, validate=validate)
 
 
-class CacheState(str, Enum):
+# Keep Enum string formatting in cache state errors.
+class CacheState(str, Enum):  # noqa: UP042
     """子依赖缓存状态"""
 
     PENDING = "PENDING"

diff --git a/nonebot/internal/permission.py b/nonebot/internal/permission.py
@@ -1,6 +1,5 @@
 from contextlib import AsyncExitStack
-from typing import ClassVar, NoReturn
-from typing_extensions import Self
+from typing import ClassVar, NoReturn, Self
 
 import anyio
 

diff --git a/nonebot/internal/rule.py b/nonebot/internal/rule.py
@@ -2,7 +2,7 @@
 from typing import ClassVar, NoReturn
 
 import anyio
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.dependencies import Dependent
 from nonebot.exception import SkippedException

diff --git a/nonebot/message.py b/nonebot/message.py
@@ -16,7 +16,7 @@
 from typing import TYPE_CHECKING, Any
 
 import anyio
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 
 from nonebot.dependencies import Dependent
 from nonebot.exception import (

diff --git a/nonebot/plugin/load.py b/nonebot/plugin/load.py
@@ -11,6 +11,7 @@
 from itertools import chain
 import json
 from pathlib import Path
+import tomllib
 from types import ModuleType
 
 from nonebot.log import logger
@@ -20,11 +21,6 @@
 from .manager import PluginManager
 from .model import Plugin
 
-try:  # pragma: py-gte-311
-    import tomllib  # pyright: ignore[reportMissingImports]
-except ModuleNotFoundError:  # pragma: py-lt-311
-    import tomli as tomllib  # pyright: ignore[reportMissingImports]
-
 
 def load_plugin(module_path: str | Path) -> Plugin | None:
     """加载单个插件，可以是本地插件或是通过 `pip` 安装的插件。

diff --git a/nonebot/utils.py b/nonebot/utils.py
@@ -42,7 +42,7 @@
 
 import anyio
 import anyio.to_thread
-from exceptiongroup import BaseExceptionGroup, catch
+from exceptiongroup import catch
 from pydantic import BaseModel
 
 from nonebot.log import logger

diff --git a/pyproject.toml b/pyproject.toml
@@ -13,7 +13,7 @@ classifiers = [
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
 ]
-requires-python = ">=3.10, <4.0"
+requires-python = ">=3.11, <4.0"
 dependencies = [
   "yarl >=1.7.2, <2.0.0",
   "anyio >=4.4.0, <5.0.0",
@@ -22,7 +22,6 @@ dependencies = [
   "exceptiongroup >=1.2.2, <2.0.0",
   "python-dotenv >=0.21.0, <2.0.0",
   "typing-extensions >=4.6.0, <5.0.0",
-  "tomli >=2.0.1, <3.0.0; python_version < '3.11'",
   "pydantic >=1.10.0, <3.0.0, !=2.5.0, !=2.5.1, !=2.10.0, !=2.10.1",
 ]
 
@@ -127,7 +126,7 @@ mark-parentheses = false
 keep-runtime-typing = true
 
 [tool.pyright]
-pythonVersion = "3.10"
+pythonVersion = "3.11"
 pythonPlatform = "All"
 defineConstant = { PYDANTIC_V2 = true }
 executionEnvironments = [

diff --git a/tests/.coveragerc b/tests/.coveragerc
@@ -21,7 +21,5 @@ rules =
   "sys_platform != 'win32'": py-win32
   "sys_platform != 'linux'": py-linux
   "sys_platform != 'darwin'": py-darwin
-  "sys_version_info < (3, 11)": py-gte-311
-  "sys_version_info >= (3, 11)": py-lt-311
   "package_version('pydantic') < (2,)": pydantic-v2
   "package_version('pydantic') >= (2,)": pydantic-v1
diff --git a/tests/plugins/plugin/matchers.py b/tests/plugins/plugin/matchers.py
@@ -1,4 +1,4 @@
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 
 from nonebot import (
     CommandGroup,
@@ -33,7 +33,7 @@ async def handler():
     return
 
 
-expire_time = datetime.now(timezone.utc)
+expire_time = datetime.now(UTC)
 priority = 100
 state = {"test": "test"}
 

diff --git a/tests/test_param.py b/tests/test_param.py
@@ -2,7 +2,6 @@
 import re
 import sys
 
-from exceptiongroup import BaseExceptionGroup
 from nonebug import App
 import pytest