VS Code中如何在大纲面板显示# %%定义的Python代码单元格标题

VS Code默认不会将# %%标记的Python单元格标题纳入大纲面板，但可以通过以下两种方式实现需求：

方案1：使用第三方扩展 #

在VS Code扩展市场搜索并安装Python Cell Outline或类似功能的扩展，这类扩展专门针对Spyder风格的# %%单元格标题设计，安装启用后会自动在大纲面板中识别并展示这些标题，无需额外配置。

方案2：自定义大纲匹配规则 #

手动修改VS Code的用户设置（settings.json），添加自定义大纲符号规则，让编辑器识别# %%开头的标题行：

1. 打开设置面板（快捷键Ctrl+,），点击右上角的打开设置(JSON)图标。
2. 在settings.json中添加以下配置：

"outline.customSymbols": [
    {
        "name": "Python Cell Header",
        "icon": "symbol-function",
        "pattern": "^# %%\\s*(.*)$",
        "kind": "Function"
    }
]

3. 保存设置后，大纲面板会自动识别并显示所有# %%开头的单元格标题。如果需要调整标题在大纲中的层级或图标，可以修改kind（如Class、Method等）和icon参数。

补充说明 #

如果希望单元格标题显示在对应函数（如示例中的main）的层级下，需要确保# %%行位于函数定义的缩进范围内，同时调整自定义规则的匹配逻辑，示例调整后的正则表达式：

"pattern": "^\\s+# %%\\s*(.*)$"

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