Bokeh 3.10.0 起不再支持 Python 3.10/3.11，升级前如何确认环境兼容？

Bokeh 3.10.0 起不再支持 Python 3.10/3.11，升级前如何确认环境兼容？

【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh

如果你计划把 Bokeh 项目从旧版本升级到 3.10.0，需要先确认运行环境的 Python 版本是否满足要求。3.10.0 的发布说明明确列出了两项变更：移除对 Python 3.10 的支持（PR #14865）和移除对 Python 3.11 的支持（PR #15174），见 3.10.0 发布说明。如果你的解释器还是 3.10 或 3.11，升级到 3.10.0 之前就必须先更换 Python 版本；本文给出从仓库文档中可核对的确认步骤。

3.10.0 对 Python 版本要求的变化

从版本时间线看（来源均为仓库内的发布说明）：

• 3.1.0：Official support for Python 3.11，见 3.1.0 发布说明；
• 3.9.0：Added support for Python 3.14（PR #14663），见 3.9.0 发布说明；
• 3.10.0：Dropped support for Python 3.10 和 Python 3.11，即最低支持的 Python 版本从 3.10 上移到 3.12。

当前代码库 pyproject.toml 中的声明可以进一步佐证这一点：

requires-python = ">=3.12"

且项目声明的 Python 版本分类为Programming Language :: Python :: 3.12、3.13、3.14，即官方覆盖范围是 CPython 3.12～3.14。

安装文档 中的 "Supported platforms" 一节也说明：Bokeh 官方支持（并持续测试）的是pyproject.toml中requires-python声明的最低 CPython 版本及更高版本；在其他 Python 版本上 Bokeh可能能运行，但不提供任何保证或支持。

升级前确认当前环境

确认流程只有两步：先看解释器版本，再看当前安装的 Bokeh 版本。

1. 查看 Python 解释器版本

python --version

• 输出在Python 3.12及以上：满足 3.10.0 的版本要求，可以继续下一步。
• 输出为Python 3.10.x或Python 3.11.x：不满足 3.10.0 的要求，需要先安装 3.12 或更高版本的 Python 并迁移虚拟环境，不要直接用该解释器升级 Bokeh。

注意文档只承诺 CPython 的支持。如果你使用的是其他 Python 实现，安装文档没有给出保证，需自行评估。

2. 查看当前 Bokeh 版本

安装文档提供的验证命令是：

bokeh info

该命令输出中会包含当前安装的 Bokeh 版本信息。用它确认你当前处于哪个旧版本（例如 3.9.x），以便对照上面的时间线判断你依赖的 Python 3.10/3.11 特性是否会在升级后失效。

升级与验证

确认 Python 解释器为 3.12 或更高后，按安装文档执行升级：

pip install bokeh

或使用 conda（需先安装 Anaconda/Miniconda）：

conda install bokeh

如果希望每次新发布后都能装到最新版本，安装文档给出的是直接从 Bokeh channel 安装：

conda install -c bokeh bokeh

可选分支：如果你需要额外功能或导出能力，可以安装带 extras 的版本，例如pip install "bokeh[all]"，其中all包含extra（pandas 等）、export（playwright，用于 PNG/SVG 导出）和sampledata，见 安装文档。

升级后再次运行bokeh info，确认输出中的 Bokeh 版本号为 3.10.0 及以上，且整个流程在 3.12+ 的 Python 解释器下执行。

边界与限制

• 官方支持范围以文档声明为准：CPython 3.12 及以上为"受支持并持续测试"的范围，3.10/3.11 在 3.10.0 中已明确移除支持，文档没有提供在这两个版本上继续运行的任何配置或规避方式。
• 安装文档 提到若bokeh info报错，可借助社区渠道排查，但文档没有给出针对"旧 Python 版本安装失败"的具体错误文本；因此判断依据应停留在版本核对这一步，而不是猜测错误信息。
• 3.10.0 中还包含其他与版本相关的变更（例如 CustomJS 模板字符串简化标注为 "Python 3.14+"），如果你同时用到这些特性，需要按发布说明逐项核对。

【免费下载链接】bokehInteractive Data Visualization in the browser, from Python项目地址: https://gitcode.com/GitHub_Trending/bo/bokeh