notepad-- 代码折叠完整上手：5 分钟把千行代码压缩成一张"地图"

【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器，目标是做中国人自己的编辑器，来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--

你是否也有过这样的时刻：接手一个几千行的老项目，光是搞清楚"这个文件里到底有哪些函数、谁嵌套在谁里面"，就得上下滚动十几分钟？notepad-- 的代码折叠（Code Folding）功能，正是为解决这类"大海捞针"式阅读体验而生——它能把一屏装不下的代码块收纳成一行摘要，让你像看目录一样浏览整个文件。本文用一套可复现的操作流程，带你从零掌握这个国产编辑器里最实用的导航利器。


为什么翻了几百次滚动条，还是记不住代码结构？

回想一下你读代码的老办法：先从头滚到尾"扫一遍"，记住大概位置；真要看某个函数时再滚回去。文件超过 1000 行时，这种做法基本失效——函数边界记不住，嵌套层级理不清，改一行代码还要反复确认它属于哪个作用域。Windows 自带记事本在这点上几乎是空白：没有行号、没有语法高亮，更谈不上折叠。你需要的不是"能打开文件"的工具，而是能把结构"可视化"出来的工具。

notepad-- 的折叠功能恰好补上这块短板。它基于 Scintilla 编辑组件实现，核心逻辑封装在src/scintillaeditview.cpp中，默认就开启了树形折叠样式。也就是说，装好就能用，不需要任何额外配置。

第一步：如何让一段代码"一键变短"？

打开任意一个 C/C++、Java、JavaScript 文件，注意看行号左侧：有一列窄边距，上面显示着-（可折叠）或+（已折叠）的小符号，这就是折叠边距。

• 鼠标点击：点-符号，当前代码块收起为一行；点+符号重新展开；
• 双击行首：双击函数定义行（如void processData() {），整块函数体立即折叠；
• 右键菜单：在编辑区右键，通过「折叠」子菜单可执行全部折叠、全部展开等批量操作。

小技巧：折叠后 Scintilla 会用一条加粗的缩进线提示"这里藏了内容"，光标悬停时还能看到被折叠部分的行数统计，方便你判断要不要展开。

第二步：怎么只显示"第 N 层"结构？

只折叠单个块还不够。真正高效的是按层级整体折叠——把文件折叠到"只看函数名"这一层，相当于给整个文件生成一张目录。

notepad-- 在src/shortcutkeymgr.cpp中预设了一整套层级快捷键：

实测一个 2000 行的 C++ 文件：按Alt+1后，屏幕上只剩十几个函数签名，一眼看清文件由哪些模块组成；需要看某个函数内部时，Alt+Shift+2展开一层，循环和条件语句就露出来了。源码中MAX_FOLD_COLLAPSE_LEVEL = 8这个常量（见src/scintillaeditview.cpp），就是这套 8 级折叠能力的上限。

第三步：不同语言为什么折叠得"不一样准"？

你可能好奇：C++ 靠{}识别块结构，那 Python 呢？它根本没有花括号。notepad-- 为此内置了语法感知折叠，在src/scintillaeditview.cpp的isFoldIndentBased()函数中明确列出：Python、CoffeeScript、Haskell、VB、YAML 等语言走缩进折叠路线——按代码缩进层级生成折叠点，而不是找括号。

• C/C++ / Java / JavaScript：基于{}块结构，还支持#region/#endregion自定义折叠区域；
• Python / YAML：按缩进层级折叠，函数、类、循环自动分组；
• HTML / XML：按标签嵌套折叠，自闭合标签会被正确识别；
• Markdown：按标题层级（#、##…）折叠章节。

这意味着你不需要手动切换模式，打开什么文件，notepad-- 就用对应的规则帮你折叠，识别错乱的概率很低。

实战：一次完整的"结构化阅读"流程

假设你刚接到一个 3000 行的模块，需要快速评估改动范围。完整流程如下：

1. 打开文件，按下Alt+1，整个文件折叠到最外层——屏幕上只剩类名和函数签名，先建立全局认知；
2. 对照「函数列表」面板（Alt+F1），找到疑似需要改动的函数，用鼠标点击它的行首折叠符，单独展开这一块；
3. 按下Alt+Shift+3，仅让当前视野展开到第 3 层，把循环和分支看清楚；
4. 改完代码后按Alt+Shift+8全部展开，逐段确认没有遗漏嵌套关系。

整个流程下来，你几乎没有滚动过页面，文件结构却了然于胸。这种"先总览、后局部、再验证"的节奏，正是折叠功能最值钱的用法。

常见问题：折叠用不顺手怎么办？

Q：折叠边距不见了？A：在「视图」菜单中找到显示边距相关选项，勾选折叠边距即可恢复。若仍不显示，检查该文件是否被识别为纯文本（TXT 类 lexer 默认不做折叠）。

Q：Python 文件折叠点不在预期位置？A：确认文件语言被识别为 Python（看底部状态栏的语法提示）。缩进折叠依赖正确的缩进层级，如果代码里混用了 Tab 和空格，建议先统一缩进风格。

Q：快捷键被其他功能占用了？A：进入「设置 > 快捷键管理」，搜索"折叠"或"Fold Level"，可自定义或重置折叠相关快捷键，支持冲突检测。

Q：折叠后内容会丢吗？A：不会。折叠只是视图层面的隐藏，文件内容始终完整，保存、查找、替换等操作都基于真实内容进行。

把折叠变成你的阅读习惯

回到开头的场景：那个让你翻了十几分钟的项目文件，现在用Alt+1一秒就能看出全貌。代码折叠不是花哨的展示功能，而是把"读代码"这件事从体力活变成脑力活的关键工具。建议你今天就用它打开手头最大的那个文件，按一遍Alt+1到Alt+8，体会结构从混沌到清晰的过程。

notepad-- 支持 Windows / Linux / macOS 三个平台，完全免费。克隆源码自行编译，或直接下载对应系统的安装包，几分钟后就能开始你的第一次折叠之旅。

【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器，目标是做中国人自己的编辑器，来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--