vscode python代码默认不自动折叠，需同时满足foldingstrategy设为indentation、正确识别python语言、开启折叠控件；常见失效原因包括folding禁用、折叠按钮隐藏、语言模式错误、缩进混用等。
VSCode 默认不“自动折叠”Python代码，所谓“自动”其实是靠 editor.foldingStrategy 设为 indentation + 正确语言识别 + 折叠控件开启三者协同生效；开箱即用的 auto 模式对普通函数/类折叠不稳定，尤其在缩进混合 TAB 和空格、或存在嵌套注释时容易漏折。
为什么 Python 函数没出现 ▶ 折叠图标？
不是插件坏了，是 VSCode 没识别出可折叠结构。常见原因：
-
editor.folding被设为false（静默失效，无提示） -
editor.showFoldingControls是"never"（按钮彻底消失） - 右下角语言模式显示为
Plain Text或Python (Jedi)，而非Python（官方 Pylance 扩展未启用） - 文件中混用 TAB 和空格缩进，导致语言服务无法构建一致的缩进层级树
Python 必须设 indentation 折叠策略
Python 没有 {} 或 end 这类语法锚点，auto 模式依赖语言服务器语义分析，但 Pylance 默认只对 class、if __name__ == "__main__" 等少数结构提供可靠折叠。改用 indentation 后，VSCode 直接按缩进层级数空格/TAB，更贴合 Python 本质。
推荐在 settings.json 中添加语言专属配置（避免影响其他语言）：
"[python]": {
"editor.foldingStrategy": "indentation",
"editor.foldImportsWhenOpen": true,
"editor.folding": true,
"editor.showFoldingControls": "mouseover"
}
注意：editor.foldImportsWhenOpen 是 Python 特有设置项，全局 editor.foldImportsByDefault 无效。
#region 在 Python 里怎么写才生效？
VSCode 原生支持 Python 的 #region，但格式极其敏感：
- 必须是单行注释开头：
#region utils（✅ 正确）；// #region（❌ JS 写法，Python 不认）；# #region（❌ 多一个空格） -
#endregion必须与#region**完全同级缩进**，哪怕差一个空格也不闭合 - 不能跨多行注释：
"""#region config"""或'''#endregion'''完全无效 - 需确保
python.languageServer是Pylance（非 Jedi），且python.analysis.semanticFolding可选开启（仅增强 import 折叠，不替代#region）
折叠状态不会保存，打开文件还是展开的？
VSCode 默认不记忆每个文件的折叠状态。想让某个 Python 文件每次打开都保持上次折叠状态，必须启用 editor.restoreViewState（默认已开启），但该功能只在「同一窗口内重开」时有效。如果关掉窗口再重开，或从命令行 code file.py 启动，状态会丢失。
真正可靠的“打开即折叠”只有两种方式：
- 对 import 块：启用
"editor.foldImportsWhenOpen": true（仅限 Python） - 对任意逻辑块：用
#region包裹，并接受它首次打开时仍需手动点一次 ▶（VSCode 不支持“首次打开自动执行折叠命令”）
别信网上搜到的 editor.autoFold——这个配置项根本不存在，是旧版文档残留的误导信息。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
