如何阻止VSCode中已折叠的代码自动展开

问题涉及运行环境 #

• 操作系统：Windows 10 19044.1706
• 编辑器版本：VSCode 1.67.2
• 开发环境：Python 3.10.2（venv虚拟环境）

问题表现 #

手动折叠的代码块会在编辑操作、切换文件、语法校验触发时无理由自动展开，尝试通用配置修复方案后问题仍可复现，问题表现如下：

分步修复配置 #

1. 调整编辑器核心折叠设置 #

按快捷键Ctrl+,打开VSCode设置面板，搜索对应配置项直接修改：

• 将Editor: Folding Strategy从默认的auto修改为indentation
  基于语法树的自动折叠策略会在语法解析、代码补全、错误校验触发时全量刷新折叠状态，是Python开发场景下折叠自动展开的最高频诱因，切换为基于缩进的折叠策略后不会被语法服务强制重置状态。
• 取消勾选Editor: Auto Reveal
  该配置默认开启时，只要光标定位到折叠区域内的代码位置，就会自动展开对应折叠块，关闭后不会因为光标跳转触发展开。
• 取消勾选Editor: Unfold On Click After End Of Line
  避免点击行尾空白区域时误触发折叠块展开。

2. 针对Python场景添加专属配置 #

点击设置面板右上角的Open Settings (JSON)按钮，在配置文件中添加以下字段：

{
  "editor.foldingImportsByDefault": false,
  "editor.stickyScroll.enabled": false,
  "python.experiments.enabled": false,
  "python.analysis.diagnosticMode": "openFilesOnly"
}

各配置作用说明：

• editor.foldingImportsByDefault: false：关闭导入区块的自动折叠逻辑，避免Python扩展刷新导入列表时重置全局折叠状态
• editor.stickyScroll.enabled: false：1.67版本的粘性滚动功能存在已知bug，滚动页面时会强制展开光标所在的折叠块，关闭即可规避
• python.experiments.enabled: false：关闭Python扩展的实验性灰度功能，避免未稳定的逻辑触发视图刷新
• python.analysis.diagnosticMode: "openFilesOnly"：将语法分析范围缩小到当前打开的文件，避免全工作区扫描时刷新当前文件的折叠状态

3. 插件冲突排查 #

如果以上配置完成后问题仍存在，优先排查第三方格式化、语法增强类插件：旧版本的autopep8、black、代码片段类插件在执行格式化、插入代码片段操作后会全量刷新文档视图，重置所有折叠状态，将这类插件升级到最新版本，或替换为Python扩展内置的对应能力即可解决。

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