php-mode 默认缩进错误是因为其基于 cc-mode 且未适配 PSR-12 等规范,需显式设置 c-basic-offset、php-indent-level 和 c-offsets-alist 中至少 7 个偏移项。

php-mode 默认缩进为什么不对
Emacs 自带的 php-mode 实际上是基于 cc-mode 的派生模式,它不直接读取 .editorconfig,也不默认适配 PSR-12 或 Laravel 等主流 PHP 风格。常见现象是:if 块内缩进 2 格、function 大括号换行后缩进错位、array() 内元素对齐异常——本质是 c-offsets-alist 中的钩子未按 PHP 语义正确设置。
覆盖 php-mode 缩进的关键变量
必须显式重置以下三个变量,仅设 tab-width 或 indent-tabs-mode 不起作用:
-
c-basic-offset:控制「每级缩进多少空格」,PSR-12 要求为4 -
php-indent-level:专用于 PHP 的缩进基准值,需与c-basic-offset一致,否则if/foreach块会错乱 -
c-offsets-alist:核心,要覆盖arglist-cont、arglist-close、inclass等 7+ 个符号的偏移规则
漏掉任意一项,都可能出现「按 Tab 缩进了,但回车换行后自动退格」或「数组键值对无法垂直对齐」。
推荐的 minimal php-mode 配置(兼容 Emacs 27+)
把这段加到你的 init.el 或 early-init.el 的 (add-to-list 'auto-insert-alist ...) 之后:
立即学习“PHP免费学习笔记(深入)”;
(add-hook 'php-mode-hook
(lambda ()
(setq c-basic-offset 4)
(setq php-indent-level 4)
(c-set-offset 'arglist-cont 0)
(c-set-offset 'arglist-close 'c-lineup-arglist-close)
(c-set-offset 'inclass '+)
(c-set-offset 'inline-open 0)
(c-set-offset 'statement-case-intro '+)
(c-set-offset 'substatement-open 0)
(c-set-offset 'substatement-close 0)))
注意:c-set-offset 必须在 hook 里动态调用,写成 (setq c-offsets-alist ...) 全量赋值反而容易覆盖 cc-mode 底层必需的默认项。
数组和箭头函数缩进异常怎么办
PHP 7.4+ 的箭头函数 fn ($x) => $x * 2 和长数组在默认配置下常缩进过深。根本原因是 arglist-cont 没被正确识别为「续行」而非「新语句」:
- 如果数组键用字符串且跨多行,确保启用了
electric-indent-local并设为t - 对箭头函数,额外加一行:
(c-set-offset 'arglist-cont-nonempty '+) - 若仍错位,临时测试:在 PHP 文件中执行
M-x c-show-syntactic-information,看光标处返回的 offset 符号是否匹配你设的值
真实项目里,Laravel 的 return view(...)->with(...) 链式调用最易暴露这个问题——不是配置没生效,而是 cc-mode 把 -> 当作运算符而非调用延续,需要手动补 c-offsets-alist 条目。











