企业官网建设流程全解析

notepad-- 代码折叠完整教程：8 级快捷键，一秒把长文件压成骨架图

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

五万行、还是五百行？先别数。打开一个几千行的文件，如果连当前看的是哪个变量都要靠滚动条回忆，问题往往不在代码本身，而在于你一直在用"全分辨率"看它。notepad-- 的代码折叠解决的就是这一件事：随时把长文件压成一张骨架图，再随时按一键还原。这篇 notepad-- 代码折叠教程，用 5 分钟带你跑通全部基础操作、折叠判定原理、1~8 级快捷键和#region自定义折叠块。

三步完成第一次折叠：零配置代码折叠入门

任何有嵌套结构的文件（C++、Python、JSON 都可以）打开后，注意看行号左边那条窄边距——那是折叠边距，上面每隔几行就有-或+小标记，每个标记对应一块可以收起的代码。

第一次使用，只需三个动作，全程不用碰任何设置：

1. 把鼠标移到某个函数定义行旁边的-上，单击一次——整个函数体收起，只剩一行函数签名；
2. 在折叠边距上点右键，菜单里选"全部折叠"，整份文件瞬间缩成一排"骨架行"；
3. 按Alt+Shift+1，文件完整还原，一个字节没动。

这里有个新手最常误解的点，先说清楚：折叠是"隐藏"，不是"删除"。折叠状态下你可以照常滚动、复制，甚至直接对着折叠头那一行打字——notepad-- 会把输入的内容安全地放回块内部，不会挤坏结构。所以别怕按错键，Alt+Shift+1永远是你的后悔药。

折叠判定原理：花括号型与缩进型两套策略自动切换

notepad-- 的折叠引擎继承自 Scintilla 编辑组件（Qt 生态里广泛使用的代码编辑内核），核心机制一句话：给每一行打一个"层级标签"。

• 对 C/C++、Java 这类花括号语言，词法分析器会把带{的行标为折叠头，并附带一个层级数字（嵌套多深就是几级）；
• 块内的每一行记录自己属于哪一级；
• 渲染时，遇到已折叠的折叠头，直接跳过它名下的所有子行，只保留头那一行。

所以"折叠层级"不是玄学，而是嵌套深度本身。

麻烦的是另一类语言：Python、YAML 这些根本没有花括号。notepad-- 的处理方式是——折叠完全靠缩进推算，由词法规则自动决定，你不需要切换任何开关。在 src/scintillaeditview.cpp 里，判断逻辑就是下面这段，一眼能看全：

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; }

Python、CoffeeScript、Haskell、VB、YAML 五种缩进敏感语言命中后，折叠引擎就走缩进推算分支；其余语言默认按花括号结构走。同一套快捷键，在不同语言文件里自动切换判定策略——这也是为什么你在 C++ 里折叠的是{}块，在 Python 里折叠的却是缩进块。

折叠层级快捷键全解：1~8 层一键伸缩

鼠标点符号直观，但连续点二十次就很费手腕。真正的效率来自 src/shortcutkeymgr.cpp 里注册的那套层级快捷键，默认绑定如下：

关键理解：Alt+2不是"折叠某一个块"，而是"把全文所有层级低于 2 的内容统统收起"。调用链路也很短：快捷键触发 src/cceditor/ccnotepad.cpp 的doFold()，它转手调用pEdit->collapse(level, mode)——即 src/scintillaeditview.cpp 中的核心折叠函数，一次遍历整份文档即可生效，十万行的文件也不用等。

掌握这套按键后，推荐一个我称之为**"三档变焦法"**的阅读工作流，模拟相机变焦去看长文件：

1. 蓝图档：打开文件先按Alt+1，整份文件缩成一张蓝图，每个函数、每个类只剩一行签名，全貌五秒钟尽收眼底；
2. 地探档：目光锁定感兴趣的模块，把鼠标移过去，按Alt+Shift+3（或直接点边距上的+），只把这一片区域放出来，其余保持收起；
3. 显微档：确认要动哪几行后，Alt+Shift+8彻底还原，把注意力圈在 50 行以内的编辑范围内。

三个按键完成一次"看全貌 → 进区域 → 盯细节"的完整循环，比滚动条来回拖快出一个量级。这套节奏对排查 bug、评审陌生代码尤其管用：先保证方向没看错，再谈细节。

#region自定义折叠块与高频坑速查 📌

语言自带的结构有时不够用——一个 2000 行的类里塞着十几个互相独立的功能段。C/C++ 等语言支持用注释标记圈出自定义折叠块：

// #region 数据处理 void processData() { /* 两百行复杂逻辑 */ } // #endregion // #region 界面渲染 void renderUI() { /* 一百五十行布局代码 */ } // #endregion

写完这两对标记，折叠边距上就会为每个区块单独生成折叠头，从此"数据处理"和"界面渲染"是可以一键收起、一键展开的独立分区，而不是埋在代码里没人看见的路标。

折叠状态和查找替换完全兼容：你在收起的文件里做全局替换，被隐藏的行照样会被正确处理，不会"看不见就漏掉"。

最后是一张三行就能扫完的踩坑速查表：

60 秒自测清单

逐条打勾，全中就代表这套折叠能力已经装进你的肌肉记忆：

• 能说出折叠边距上-和+分别代表什么状态
• 能用一个按键把整份文件折成"骨架"，也能一键还原
• 知道 Python 文件的折叠依据是缩进而非花括号
• 会用#region/#endregion给大文件划分可折叠的逻辑分区
• 边距不显示、快捷键失灵时知道去哪里找开关

notepad-- 是一款同时支持 Windows / Linux / macOS 的国产跨平台文本编辑器，以"做出中国人自己的编辑器"为目标，代码折叠只是它编辑能力的其中一角。想继续深入，源码入口在src/目录下：折叠核心逻辑见 src/scintillaeditview.cpp（collapse()/isFoldIndentBased()），快捷键注册见 src/shortcutkeymgr.cpp，调用链上游见 src/cceditor/ccnotepad.cpp。

文档版本：v3.7.0 ｜ 最后更新：占位符（请按实际发布时间填写）

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