切换至sphinx_rtd_theme后，如何启用viewcode关联代码块高亮？

Hey there! 我之前切换到sphinx_rtd_theme时也碰到过这个问题，折腾了一阵终于找到几个可行的方案，分享给你：

1. 确认viewcode扩展已正确启用 #

虽然你大概率已经开了，但还是先检查下conf.py里的扩展配置，确保sphinx.ext.viewcode在列表里：

extensions = [
    # 你的其他扩展...
    'sphinx.ext.viewcode',
]

2. 添加自定义CSS恢复高亮效果 #

sphinx_rtd_theme默认没有包含viewcode关联区块的高亮样式，所以我们可以自己补上：

• 第一步：在你的Sphinx项目的_static目录下创建custom.css文件（如果_static不存在就新建一个）
• 第二步：在custom.css里添加以下样式（颜色可以根据你的喜好调整）：

/* 针对viewcode跳转后的代码块高亮 */
.viewcode-link:target + .viewcode-block {
    background-color: #fff9e6; /* 还原alabaster的淡黄色背景 */
    border-left: 3px solid #fcc26a; /* 增加左侧边框强化视觉提示 */
    padding-left: 10px;
    margin-left: -10px;
}

/* 如果上面的选择器不生效，试试这个针对高亮类的规则 */
.viewcode-highlight {
    background-color: #fff9e6 !important;
}

• 第三步：在conf.py里配置加载这个自定义CSS：

html_static_path = ['_static']
html_css_files = [
    'custom.css',
]

3. 更新sphinx_rtd_theme到最新版本 #

旧版本的sphinx_rtd_theme可能对viewcode的样式支持有缺陷，先升级试试：

pip install --upgrade sphinx_rtd_theme

小技巧：用开发者工具调试样式 #

如果自定义CSS没生效，可以打开浏览器的开发者工具（按F12），点击viewcode链接后，查看对应的代码块元素，看看它的类名和现有样式，然后调整你自定义CSS里的选择器，确保能准确命中目标元素。

内容的提问来源于stack exchange，提问作者Arne