UD5工具箱
什么是基于缩进的代码折叠？
基于缩进的代码折叠是一种根据代码行前导空白（空格或制表符）来判断代码块层级的技术。缩进更深的行被视为其上方缩进较浅行的“子内容”。当折叠一个代码块时，所有缩进深度大于该行、且属于该块范围内的后续行都会被隐藏，从而实现代码结构的快速浏览。这种折叠方式特别适合Python、YAML、HAML等对缩进敏感的语言。在本工具中，系统自动分析每行的前导空白，生成可折叠的代码块。
支持哪些编程语言？
本工具采用纯缩进分析，不依赖特定语言的语法，因此理论上支持所有使用缩进组织代码块的语言：Python、YAML、CoffeeScript、HAML、Slim、Starlark等。对于使用大括号的语言如JavaScript、C/C++、Java、Go，如果代码也保持了良好的缩进习惯，同样可以获得合理的折叠效果。您可以通过缩进大小选择器来适配不同项目的缩进规范，确保最佳折叠效果。
折叠后复制代码会丢失内容吗？
不会。点击“复制代码”按钮时，复制的是完整的原始代码，包括所有被折叠隐藏的行。折叠功能仅影响当前视图的显示，绝不改变底层代码内容。您可以放心地折叠代码来获得清晰的概览，同时确保复制的代码保持完整。这是因为折叠操作仅是显示层的暂时隐藏，而不是对代码数据的删除或修改。复制完成后会显示提示信息。
如何判断代码块的折叠范围？
折叠范围通过以下规则确定：从当前行开始，向下查找所有缩进深度严格大于当前行的连续行，直到遇到第一个缩进深度小于等于当前行的行为止。例如，一个缩进为0的def语句，其折叠范围将包含所有缩进大于等于1的内部代码，直到下一个缩进为0的顶层语句之前。这种规则能够精确地分割代码层次，避免跨层折叠的问题。
嵌套折叠是如何工作的？
嵌套折叠完全支持。每一层缩进都可以独立折叠。当外层代码块被折叠时，其内部所有行（包括内层折叠头）都会被隐藏。当外层展开时，内层的折叠状态会被保留——即之前折叠的内层块仍然保持折叠状态。这使得您可以逐层深入查看代码结构，就像在VS Code或PyCharm等IDE中的体验一样。嵌套折叠的状态会被完整跟踪和管理，确保操作的精细控制。
切换缩进尺寸后折叠状态会重置吗？
是的。当您切换缩进尺寸时（例如从2空格切换到4空格），工具会重新分析整个代码的结构，重新计算折叠块的边界和层级关系。所有已有的折叠状态会被重置，代码将全部展开显示。这是因为不同的缩进尺寸会导致相同的代码行被分析出不同的层级关系。例如，用2空格缩进的代码在切换到4空格模式后，部分原本的多层结构可能会被合并。建议在切换前记录当前的折叠状态。
工具是否会上传我的代码？
不会。本工具基于纯前端技术实现，所有代码处理均在浏览器本地完成，用户的代码数据不会被上传到任何服务器。这种架构设计让开发者可以安心地使用本工具处理任何敏感代码。工具不使用任何第三方统计、广告或分析插件，确保用户的完全隐私。关闭浏览器页面后，所有数据将被完全清除，不留任何留存。您可以完全信任本工具的安全性。
为什么有些代码无法折叠？
如果代码的缩进一致或缩进层次跳跃，工具可能无法正确识别代码块。例如，如果每行的缩进都相同，整个代码将被视为一个单一的代码块。另外，纯空行不会影响折叠范围的判断，但空行前的缩进仍会被计算。如果遇到无法折叠的情况，可以检查代码的缩进是否一致。建议使用自动缩进功能的编辑器来保证代码格式。同时可以尝试切换不同的缩进尺寸看是否能改善折叠效果。