notepad-- 代码折叠完整上手：5 分钟把千行代码压缩成一张“地图“
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中预设了一整套层级快捷键：
| 目标层级 | 折叠快捷键 | 展开快捷键 |
|---|---|---|
| 只看最外层结构（函数/类） | Alt+1 | Alt+Shift+1 |
| 看到条件、循环层级 | Alt+2 | Alt+Shift+2 |
| 逐层深入 | Alt+3 … Alt+8 | Alt+Shift+3 … Alt+Shift+8 |
实测一个 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 行的模块，需要快速评估改动范围。完整流程如下：
- 打开文件，按下
Alt+1，整个文件折叠到最外层——屏幕上只剩类名和函数签名，先建立全局认知； - 对照「函数列表」面板（
Alt+F1），找到疑似需要改动的函数，用鼠标点击它的行首折叠符，单独展开这一块； - 按下
Alt+Shift+3，仅让当前视野展开到第 3 层，把循环和分支看清楚； - 改完代码后按
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--
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考