“粘贴时自动缩进”开关在 settings → editor → 勾选 “auto indent on paste”；需同时开启 “soft tabs” 和 “auto indent”，否则粘贴不缩进或混入硬制表符。
“粘贴时自动缩进”开关在哪？
Atom 默认不开启粘贴自动缩进，必须手动打开——否则你 Ctrl+V 一堆代码，缩进全乱，还可能被 ESLint 报 expected indentation of 2 spaces but found 0。
操作路径很直接：Settings → Editor → 勾选 “Soft Tabs” + “Auto Indent” + “Auto Indent on Paste”。其中 Auto Indent on Paste 就是那个带 √ 的选项（2022 年起 UI 固定为该名称）。
- 如果只开
Auto Indent不开Auto Indent on Paste，手动回车换行会缩进，但粘贴不会 - “Soft Tabs” 必须开启，否则
Tab Length设置无效，粘贴后仍可能混入硬制表符（\t），导致跨平台协作出错 - 改完不用重启 Atom，但已打开的文件需重新触发一次粘贴才生效（比如删一行再粘回去）
为什么 HTML / PHP / Drupal 文件缩进总不对？
Atom 的缩进逻辑依赖 language-* 包（如 language-html、language-php），而这些包对特定框架（如 Drupal）的嵌套规则支持有限——它识别 <div>，但未必理解 <code>hook_form_alter() 里数组键值对的语义缩进层级。
- Drupal 项目建议额外安装
atom-beautify，并配置其 HTML/PHP 规则：在插件设置里把Indent with tabs关掉，Indent size设为 2（符合 Drupal 编码标准） - 若用
prettier-atom，注意它默认覆盖 Atom 原生缩进行为；一旦启用，Auto Indent on Paste实际失效，缩进由 Prettier 的prettier.tabWidth控制 - 老项目混用空格和制表符？先用
Editor: Convert Spaces to Tabs或Convert Tabs to Spaces统一，再设缩进——否则自动缩进会在混合缩进处“卡住”
想用快捷键快速重排选中代码？
不用装插件也能做：打开命令面板（Cmd+Shift+P / Ctrl+Shift+P），搜 Editor: Auto Indent，执行后当前选中块会按语言规则重缩进。
- 这个命令只作用于**已选中文本**，未选中时无效（不是全文件格式化）
- 对 JS/TS 效果好，对 PHP 数组或 Blade 模板可能缩错层——因为 Atom 原生不解析 PHP 表达式上下文
- 想全局格式化？得靠
atom-beautify的Beautify: Beautify Code或prettier-atom的Prettier: Format，它们走的是语法树，不是纯行首空格计算
init.coffee 里写 atom.config.set('editor.tabLength', 4) 还管用吗？
管用，但仅限首次启动加载——2025 年 Atom 仍支持 init.coffee，但所有配置项必须写在 atom.config.set() 调用里，且不能放在条件判断中（会被忽略）。
- 常见错误：写成
editor.tabLength = 4（少atom.config.set()包裹），实际不生效 - 更推荐改 Settings UI，因为
tabLength是用户级配置，写死在 init.coffee 里反而难调试（比如同事拉你项目，缩进突然变 4 而不是预期的 2） - 真正需要脚本干预的场景极少，比如多项目切换时动态切缩进——这种需求现在基本被
editorconfig文件替代了
最易忽略的一点：Atom 的“自动缩进”本质是基于行首空白字符的启发式推断，不是语法感知。所以遇到自定义 DSL、模板语法或非标准括号配对（比如 Twig 的 {% if %}），它大概率缩错——这时候别调设置，直接上 prettier 或 eslint --fix 更靠谱。
