企业官网建设流程全解析

notepad-- 代码折叠新手指南：3 个按键读透大文件

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

下午三点，你接到一个任务：在一份两千多行的 C++ 工程文件里改动一个函数的调用处。你按 Ctrl+F 找到了它，可函数体横跨半屏，上下还挤着十几个别的函数，光标滚来滚去，上下文全被搅乱了。这不是文件写得太烂，是你正试图一次读完所有内容。notepad-- 的代码折叠功能就是为此设计的：把不相关的代码块整体收起来，只留你关心的部分在视野里。

本文按"检查 → 体验 → 原理 → 实战 → 排坑"的顺序走：先用 3 步看到折叠效果，再用一张表看懂它背后的层级机制，最后给你 3 个真实工作场景的操作套路。

一、上手前检查：确认这 3 件事

1. 折叠边距是否存在。打开任意有嵌套结构的文件（C++、Python、JSON 都可以），看左侧行号栏旁边有没有一条窄边距，上面点缀着方形的-/+小符号。看到符号，说明功能已就绪；看不到，往下第 3 条排查。

2. 当前文件被识别成了什么语言。编辑器右下角状态栏会显示语言标识（如cpp、typescript）。语言识别正确，折叠头才会出现——这是"某些块无法折叠"最常见的原因。

3. 快捷键还在不在。打开「设置 > 快捷键管理」，搜索Fold，能列出Fold Level 1~Fold Level 8与UNFold Level 1~UNFold Level 8两组条目即正常，默认绑定为Alt+1~Alt+8与Alt+Shift+1~Alt+Shift+8。如果你之前改过绑定或与其他快捷键冲突了，可以在此处重新设置。

动手试一下：三个确认点都过了，就可以进入下面的体验流程。

二、最小体验路径：3 步看到效果

第 1 步：点击折叠。把光标放在某个函数定义行上，点边距上的-符号。 预期结果：整个函数体收起，只留下函数签名一行，符号同时变成+。

第 2 步：按Alt+1。不按任何具体位置，直接按层级快捷键。 预期结果：全文件所有第一层代码块一次性收起，几千行的文件瞬间变成一份"函数清单"。

第 3 步：按Alt+Shift+8。预期结果：文件逐层恢复成完整展开状态，滚动回第 1 步的位置核对一下——代码一行不少。

看明白了吗？这里有一个最容易被误解的点：折叠是"收起"，不是"删除"。被隐藏的行只是不在屏幕上渲染，内容原封不动，查找、替换、保存都照常作用于全文。你甚至可以在折叠状态下直接编辑折叠头那一行，编辑器会安全处理。

三、一个值得懂透的原理：给每行发"楼层号"

把文件想象成一栋楼。词法分析器在渲染每一行时，都会顺手做两件小事：

1. 给这一行写上一个楼层号（折叠层级），1 层是顶楼，数字越大越深；
2. 如果是某个块的首行，再额外挂一个"折叠头"标记，边距上的-/+符号就是挂在这类行上。

你按Alt+3时，编辑器做的事很朴素：扫一遍全文，凡是楼层号等于 3 的折叠头，统一收起来。没有魔法，就是"按楼层号批量关门"。

不同语言的差别，就出在"谁来决定楼层号"上。C/C++、Java 这类靠花括号的语言，{进一层、}出一层；而 Python、YAML 这类没有花括号的语言，楼层号由缩进深度推算。这套分支逻辑就写在折叠入口处：

bool ScintillaEditView::isFoldIndentBased() const { QsciLexer* lexer = this->lexer(); if (lexer != nullptr) { int lexerId = lexer->lexerId(); return lexerId == L_PYTHON || lexerId == L_COFFEESCRIPT || lexerId == L_HASKELL || lexerId == L_VB || lexerId == L_YAML; } return false; }

也就是说，同一组快捷键，在 C++ 里折叠的是{}块，在 Python 里折叠的是缩进块——编辑器根据当前文件的语言自动切换策略，你不需要任何手动配置。

四、3 个实战场景

场景 1：接手陌生代码，先扫结构。背景：第一次打开一个没接触过的大文件。 操作：按Alt+1收出全文件骨架；找到目标函数后，只对它点边距上的+展开，其余保持收起。 结果：你的注意力被限制在一个函数体内，阅读范围从几千行缩到几十行。

场景 2：大文件里划"逻辑分区"。背景：语言自带的函数边界不够用，你想按业务模块组织代码。 操作：在 C/C++ 注释里写// #region 模块A和// #endregion圈出一段；#endregion之后的另一段用// #region 模块B再圈一次。 结果：边距上为这两个 region 各生成一个折叠头，模块可以一键收起、一键展开，比翻函数边界更符合你的心智模型。

场景 3：折叠状态下干活。背景：文件收拢成清单后，你需要改一处字符串、或全局替换一个变量名。 操作：直接开「查找 > 查找与替换」执行全局替换，不需要先全部展开。 结果：被隐藏的行同样会被正确替换，"看不见"不等于"不存在"，省掉展开—替换—再收起的往返。

五、不 work 时先看这里

六、收尾

一句话口诀：大文件先收楼，按层开窗看细节。

• 能在行号旁找到折叠边距，并说清-和+分别代表什么
• 会用Alt+1把陌生文件收成骨架、再定向展开目标函数
• 清楚 Python 的折叠依据是缩进，而 C++ 是花括号
• 能用// #region给大文件划出可折叠的逻辑模块
• 知道在「设置 > 快捷键管理」里查看和重置折叠快捷键
• 回到开头那两千行 C++ 文件：先Alt+1看清单，再定位、再展开，全程不超过三次滚动

notepad-- 是一款支持 Windows / Linux / macOS 的国产文本编辑器，目标是做出可自主替代的跨平台编辑工具。想继续深入，建议直接读折叠核心实现 src/scintillaeditview.cpp（collapse()与isFoldIndentBased()）和快捷键注册 src/shortcutkeymgr.cpp；项目整体介绍见 README.md。

文档版本：待填写（请以实际发布版本为准）

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