PyCharm代码折叠由IDE设置中的Code Folding页面统一配置,需区分项目设置与IDE设置;关键项包括Fold by default(控制默认折叠内容)和Show code folding arrows(推荐设为Always)。

PyCharm 默认开启代码折叠功能,但是否自动折叠、折叠哪些内容、图标是否常显,全由 Settings 里的配置决定。直接改设置比记快捷键更治本。
怎么打开代码折叠设置页面
Windows/Linux:点击 File → Settings → Editor → General → Code Folding
macOS:点击 PyCharm → Preferences → Editor → General → Code Folding
- 这个路径是固定入口,不随版本大幅变动(2023–2026 各主流版本均适用)
- 别在搜索框里输“folding”后乱点——有些操作名是
Fold Methods或Fold Comments,但真正控制默认行为的只有这一页 - 如果没看到
Code Folding项,说明你当前选中的是项目设置(Project Settings),要切到 IDE 设置(IDE Settings)
关键配置项:哪些代码默认折叠
Fold by default 列表决定了文件一打开就自动收起什么。勾选 ≠ 强制折叠,而是“首次加载时按此规则折叠”
-
Imports:折叠所有import块(含from ... import),适合大型模块依赖场景 -
Docstrings:多行字符串文档自动收起,避免被长 docstring 挤占视野 -
Comments:普通注释(#行或"""块)默认隐藏,对写说明性注释多的项目很实用 -
Methods和Functions:注意二者是分开选项,Python 中函数即def,方法即类内def;若只勾Methods,顶层函数不会被默认折叠 - 不建议勾
Inner classes或Lambda expressions:前者易误折叠嵌套类,后者折叠后几乎无法编辑
折叠图标显示逻辑容易被忽略
Show code folding arrows 控制左侧边栏箭头是否常驻,直接影响操作效率
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 选
Always:箭头永远可见,鼠标不用悬停就能点 —— 推荐日常开发启用 - 选
On mouse hover:节省边栏空间,但每次都要悬停找箭头,实际反而拖慢节奏 - 勾选
Show bottom arrows:会在折叠块末尾加一个向下小箭头,方便快速定位收起区域的结束位置;尤其对长函数或大 if 块有用 - 如果开了
Always却看不到箭头,检查是否被其他插件(如 Rainbow Brackets)遮挡,或主题配色导致图标颜色过淡
自定义快捷键前先确认冲突
PyCharm 默认快捷键在不同键盘布局下可能失效,比如 NumPad 键区未启用时 Ctrl + Shift + NumPad - 根本不响应
- 进
Keymap页面后搜folding,重点看四组动作:Collapse All、Expand All、Collapse Region、Expand Region - Windows 用户慎用
Ctrl + -:它常被系统缩放快捷键劫持(尤其是高 DPI 屏幕),建议改用Ctrl + Alt + - - macOS 用户若用外接键盘无 NumPad,
Cmd + Shift + -可能触发系统音量调节,应绑定到Cmd + Option + - - 改完快捷键务必点右下角
Apply,不是OK——后者会关闭窗口但不保存部分设置
折叠不是为了把代码藏起来,而是让结构可感知。真正卡住人的往往不是“怎么折”,而是“为什么折了看不见箭头”或“一开文件就全垮掉”。把 Show code folding arrows 设为 Always,再挑 1–2 个最常折叠的类型设为默认,比盲目记快捷键管用得多。

















