必须安装官方language-php包才能启用PHP语法高亮与基础支持；装错包会导致.php文件始终显示为Plain Text，无高亮、无折叠、括号不匹配；正确安装后需手动设置Grammar: PHP并勾选Save as Default for .php，同时在config.cson中配置fileTypes: {'.php': 'source.php'}确保生效。
language-php 包没装对，.php 文件永远是 Plain Text
Atom 默认不带 PHP 语法支持，language-php 是唯一应安装的官方包——不是 php、php-snippets 或 autocomplete-php。这些名字相似的包只提供补全或格式化，不负责解析结构。装错会导致 .php 文件始终显示为 Plain Text，无高亮、无折叠、括号不匹配。
正确安装路径：Atom → Preferences → Install → 搜索 language-php → 找作者为 atom、描述含 Official PHP language support 的包 → Install。装完别急着写代码，先验证是否生效。
右下角状态栏显示不是 PHP？手动指定并设为默认
即使装了 language-php，新打开的 .php 文件仍可能被识别为 Plain Text 或 HTML，尤其当文件未保存或扩展名被其他插件劫持时。
- 打开一个 .php 文件，看右下角状态栏显示的是什么（如
Plain Text、HTML、PHP） - 点击该文字 → 选择
Grammar: PHP→ 勾选Save as Default for .php - 若勾选后仍无效，检查
config.cson中是否被其他规则覆盖：core.fileTypes里不能有'.php': 'text.html'这类冲突映射
为什么保存后切换了语法，新开文件又变回 Plain Text？
Atom 对“新建未保存文件”（untitled）默认用 Plain Text，这是设计行为，不是 bug。它不会猜测语言，必须靠 core.fileTypes 显式绑定扩展名与 grammar scope。
立即学习“PHP免费学习笔记（深入）”；
要让所有新保存的 .php 文件自动用 PHP 语法，必须编辑配置文件：
- macOS/Linux：修改
~/.atom/config.cson - Windows：修改
%USERPROFILE%\.atom\config.cson - 在
core:下添加：fileTypes: {'.php': 'source.php'} - 保存后重启 Atom 或重载窗口（
Ctrl+Shift+F5），再新建 → 保存为test.php即可生效
Editor: Log Cursor Scope 输出里没有 source.php？说明 grammar 没真正加载
这是最可靠的验证方式：按 Ctrl+Shift+P → 输入并执行 Editor: Log Cursor Scope，把光标停在 <?php 或函数名上，看控制台输出。
正常应看到类似：source.php meta.embedded.block.php；如果只看到 text.plain 或 source.html，说明：
-
language-php被禁用（去Packages页面确认 Enabled 状态） - 存在插件冲突，比如
grammar-selector强制设定了其他 grammar - 项目根目录有
.editorconfig或.atom-build.json干扰了 grammar 推导（少见但真实发生过）
真正容易被忽略的是：Atom 不会因为文件内容含 <?php 就自动切换语法，它只认扩展名 + fileTypes 配置 + 右下角手动设置三者之一。缺一不可。
