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

Sphinx文档Python代码块仅部分高亮,如何实现全量高亮?

Sphinx实现VS Code风格全量代码高亮

步骤1:安装VS Code风格的Pygments样式

  • 执行命令安装对应样式包:
    pip install pygments-style-vscode
    

步骤2:修改Sphinx配置文件(conf.py)

  • 替换原有的高亮样式配置:
    # 替换之前的 pygments_style = 'default'
    pygments_style = 'vscode'
    
  • 可选优化:若当前使用的Sphinx主题对语法高亮支持有限,建议更换为现代主题(如Furo),这类主题能更好适配完整语法高亮:
    1. 安装主题:
      pip install furo
      
    2. 在conf.py中设置主题:
      html_theme = 'furo'
      

验证效果

修改配置后重新构建文档(sphinx-build -b html docs build),Python代码块即可呈现类似VS Code的全量语法高亮效果,关键字、函数名、字符串、模块名等元素都会被精准区分高亮。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.12 20:22:02