You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

readthedocs.io用Python3.7遇类型提示错误,如何升级至Python3.11?

在Read the Docs指定Python 3.11版本解决类型提示报错问题

你遇到的type is not subscriptable错误,本质是Python 3.7不支持list[str]这种PEP 585标准的内置类型下标语法——这种写法是Python 3.9及以上才原生支持的,3.7里得用typing.List[str]替代。不过你完全可以指定Read the Docs使用Python 3.11,具体操作如下:

  • 在项目根目录新建一个名为readthedocs.yaml的配置文件
  • 写入以下配置内容:
version: 2

build:
  os: ubuntu-22.04
  tools:
    python: "3.11"

# 如果你的项目有依赖需要安装,加上下面这段(没有就删掉)
python:
  install:
    - requirements: requirements.txt
  • 将这个配置文件提交到代码仓库,然后手动触发Read the Docs的重新构建即可

这样Read the Docs就会用Python 3.11来构建文档,list[str]这类类型提示就能正常识别,autodoc也能正常工作了。

内容的提问来源于stack exchange,提问作者FancyPantsFlower

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.26 05:07:05