sublime text 的 python 代码折叠依赖语法作用域而非缩进，光标必须位于 def 或 class 行且状态栏显示 python 语言；若作用域未识别为 meta.function.python，则 ctrl+shift+[ 无效；可使用 fold_selection 手动折叠任意选中行。
Sublime Text 对 Python 代码的折叠不是靠缩进自动识别的，而是依赖语法定义中是否声明了 meta.function.python 和 meta.class.python 等作用域；光标停在 def 或 class 行才可能触发，否则按 Ctrl+Shift+[ 必然静默失败。
为什么 Ctrl+Shift+[ 在 Python 里经常没反应？
这不是快捷键坏了，是 Sublime 没把当前行识别为函数/类的起点：
- 光标必须停在
def func():或class Foo:这样的行上——停在函数体第一行（比如print("x")）、空行、注释行、docstring 行，Ctrl+Shift+[都不会响应 - 右下角状态栏必须显示
Python，不能是Plain Text；若显示错误，点击它手动选语言，或保存为.py后缀文件 - 按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，光标在def行时，状态栏应出现source.python meta.function.python；若只有source.python，说明语法包未正确加载或被插件干扰 - 装饰器跨行（如
@decorator单独一行紧贴def）或 docstring 紧挨着def行（无空行），会导致meta.function识别中断 - Tab 和空格混用缩进，会使语法高亮器提前终止 scope 推导，
meta.block链断裂
Ctrl+K, Ctrl+2 折的是“函数”还是“二级缩进”？
Ctrl+K, Ctrl+2 折的是作用域嵌套深度为 2 的结构，不是缩进空格数。在标准 Python 语法中，def 和 class 通常落在 level 2，但这个值不固定：
- 若
show_scope_name显示meta.function.python，且其嵌套层级为 2，则Ctrl+K, Ctrl+2可折函数；若显示为 level 1 或 level 3，就得试Ctrl+K, Ctrl+1或Ctrl+K, Ctrl+3 -
Ctrl+K, Ctrl+0是fold_all，会把顶层if、__all__ = []、模块级注释块甚至 docstring 全部收走，不适合只想看函数签名的场景 - 真正只折函数的命令是
fold_by_level：按Ctrl+Shift+P→ 输入fold_by_level→ 回车 → 依次试数字 2、3、1；输错无提示，没反应就换下一个
怎么绕过语法限制，任意几行都可折叠？
当函数因装饰器、缩进混乱或语法包失效而无法折叠时，fold_selection 是唯一 100% 可控的方式：
- 鼠标拖选或多行选中（如连续按
Ctrl+L选多行） - Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 左侧 gutter 出现独立三角图标，点击即可展开/收起，不影响其他自动折叠块
- 该折叠仅存在于当前会话，关闭文件即丢失；但它不依赖语法识别、不校验缩进、不读
fold_comments，哪怕你在.env或日志片段里也能立刻使用
侧边栏折叠按钮不显示？不是功能故障，是设置没开
即使 Ctrl+Shift+[ 能正常工作，左侧 gutter 仍可能看不到 ▶ 图标，这是因为 UI 渲染被禁用了：
- 打开
Preferences → Settings，在右侧用户设置中确认有这两行："fold_buttons": true"fade_fold_buttons": false - 若存在
"fold_enable": false，请删掉或改为true；某些插件会悄悄写入false，建议全局搜索确认 - 按钮只对语法识别出的结构生成（如
def、class、{），纯缩进块（如无大括号的 if 分支）不会出按钮 - 设置修改后需重载文件或重启 Sublime 才生效
最常被忽略的点是：折叠状态从不跨会话保存，关掉再打开文件，所有手动折叠一律恢复展开；Sublime 官方至今没有 "fold_on_open": true 这类配置项，所谓“持久化”只能靠插件（如 AutoFold）或反复执行 fold_selection。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
