PyCharm中如何实现代码折叠与展开

PyCharm中代码折叠与展开的实现方法

一、默认折叠规则

PyCharm会自动识别并折叠以下代码结构：类定义、函数/方法实现、代码块（如{}内的内容）。折叠后的代码显示为阴影省略号（…），左侧边栏会出现折叠开关（减号“-”表示折叠，加号“+”表示展开）。

二、常用折叠/展开操作

1. 单片段折叠/展开

• 折叠当前代码片段：将光标置于代码片段内，按Ctrl+NumPad -（Windows/Linux）或Cmd+NumPad -（macOS）；或点击左侧边栏的折叠开关（-）。
• 展开当前代码片段：将光标置于折叠的代码片段内，按Ctrl+NumPad +（Windows/Linux）或Cmd+NumPad +（macOS）；或点击左侧边栏的展开开关（+）。

2. 所有片段折叠/展开

• 折叠所有可折叠片段：按Ctrl+Shift+NumPad -（Windows/Linux）或Cmd+Shift+NumPad -（macOS）；或通过主菜单选择Code → Folding → Collapse All。
• 展开所有折叠片段：按Ctrl+Shift+NumPad +（Windows/Linux）或Cmd+Shift+NumPad +（macOS）；或通过主菜单选择Code → Folding → Expand All。

3. 递归折叠/展开

• 递归折叠当前片段：按Ctrl+Alt+NumPad -（Windows/Linux）或Ctrl+Alt+NumPad -（macOS），折叠当前片段及其所有子片段（如类中的所有方法、函数中的所有循环）。
• 递归展开当前片段：按Ctrl+Alt+NumPad +（Windows/Linux）或Ctrl+Alt+NumPad +（macOS），展开当前片段及其所有子片段。

三、自定义折叠区域

若需折叠非默认结构（如零散代码行），可通过自定义折叠区域实现：

1. 标记自定义区域：选中代码片段，按Ctrl+Alt+T，选择region...endregion注释（或输入#region 描述和#endregion）；或通过主菜单Code → Surround with → region...endregion。
2. 折叠/展开自定义区域：将光标置于自定义区域内的任意位置，按Ctrl+.（Windows/Linux/macOS）；或点击区域左侧的折叠开关。
3. 导航至自定义区域：按Ctrl+Alt+.，快速跳转到文件中的自定义折叠区域。

四、折叠设置调整

1. 显示/隐藏折叠轮廓：若不想看到左侧边栏的折叠开关，可通过File → Settings → Editor → General → Code Folding，取消勾选Show code folding outline。
2. 调整折叠图标显示：在Code Folding设置中，将Show code folding arrow改为Always（始终显示）或Mouse hover（鼠标悬停时显示），优化界面体验。

五、其他实用技巧

• 查看折叠内容：将鼠标悬停在折叠的代码片段上，会弹出临时窗口显示隐藏的代码内容。
• 展开至指定嵌套级别：按Ctrl+NumPad * + 数字（如Ctrl+NumPad * + 1）展开当前片段至1级嵌套（如类中的方法）；按Ctrl+Shift+NumPad * + 数字展开所有折叠片段至指定级别。