Sublime Text无通用“一键整理”方案，需按目标区分：Ctrl+R用于结构导航（依赖正确语法设置），Alignment仅视觉对齐（如=、:），格式化须配语言专用工具（如Black、Prettier），超大文件需关闭高亮等渲染项。
Sublime Text 本身不提供“一键整理长文件代码”的通用方案，所谓“整理”必须先明确目标：是结构导航、视觉对齐、语法格式化，还是性能优化？不同目标对应完全不同的操作路径和工具链，混用只会白忙活。
Ctrl+R 是长文件结构导航最稳的入口
它不是备用功能，而是 Sublime 原生符号列表的实时快照，不依赖插件、不生成缓存、响应零延迟。失效通常只因两个原因：
- 右下角语法模式没设对——比如 Python 文件被误识别为 Plain Text，
Ctrl+R就只显示空列表；手动点右下角切换成Python即可恢复 - 语法包本身没声明
symbolList规则——Bash、YAML 等语言常见此问题，此时Ctrl+R返回空或仅显示部分函数名，别硬调，换Outline插件试试 - 它只作用于当前文件，不跨文件聚合；文件修改后不会自动刷新，需重新按
Ctrl+R或Cmd+R
Alignment 插件只做视觉对齐，别当格式化器用
它本质是排版小刀，不是代码手术台。常见误用场景：
- 选中多行变量赋值（如
name="Alice",age=30），按Ctrl+Alt+A后对齐=，结果干净利落 - 想靠它整理 JS 对象缩进、拆分长行、重排 import？它完全不解析语法，也不会动括号或换行，必然失败
- 在非
Plain text模式下无反应？检查是否被其它插件拦截，或直接切到Plain text再试 - 注释对齐效果差（如
# foo和#bar），因它只按字符位置对齐，不处理语义空格
真正需要格式化时，必须配对语言专用工具
Sublime 自身不带格式化能力，所有“一键整理”都依赖外部 CLI 工具，且路径必须绝对正确：
- Python：用
SublimeBlack，关键配置是"use_stdin": true和black_cmd指向本地black可执行文件，否则Ctrl+Alt+L静默失败 - JavaScript/TS：用
JsPrettier，必须填对prettier_cli_path，且确保 Prettier 版本与项目兼容（v3 不兼容旧配置） - HTML/CSS：用
JSBeautify，但右下角状态栏必须显示HTML或CSS，否则会按 JS 规则乱格式化标签 - Vue 单文件组件：单独配
Vetur或prettier-plugin-vue，默认的 JS 格式化器会破坏<template>结构
超大文件（>50MB）打开就卡？关四件事再重启
卡顿根源不是文件大，而是 Sublime 默认对每行做高亮、软换行、行号渲染和语法分析。生效配置必须写在用户设置里并重启：
-
"large_file_threshold": 52428800（50MB），超过此值跳过语法高亮与折叠 -
"syntax": "Packages/Text/Plain text.tmLanguage"，强制纯文本模式，绕过所有 CSV/JSON 插件解析 -
"word_wrap": false，禁用软换行——单字段含 JSON 的日志行是性能杀手 -
"highlight_line": false，关掉当前行高亮，减少渲染压力
这些设置改完不重启无效；若仍卡，说明文件已触发 huge_file_size 限制，需同步调整该值并确认 enable_hexadecimal_encoding 为 false。
