必须安装官方 language-php 包才能启用 PHP 语法高亮与基础支持；通过 Atom 设置页搜索安装，确认作者为 atom 且描述含 Official PHP language support；装后需在右下角手动设 Grammar: PHP 并勾选 Save as Default for .php。
Atom 默认不带 PHP 语法高亮和基础支持，必须手动安装 language-php 包 —— 这是官方维护的、唯一应优先选用的 PHP 语法包。
怎么装 language-php（不是其他名字相似的包）
打开 Atom → Atom → Preferences（macOS）或 Edit → Preferences（Windows/Linux），进入设置页 → 左侧点 Install → 在搜索框输入 language-php → 找到作者为 atom、描述含 Official PHP language support 的包 → 点击 Install 按钮。
注意：php、php-snippets、atom-php-completion 等是补充功能包，不是语法支持主体；装错会导致 .php 文件不识别、无高亮、无法折叠代码块。
装完没反应？检查文件关联是否被覆盖
即使装了 language-php，如果文件扩展名未正确关联，Atom 仍会用纯文本模式打开 .php 文件。需手动确认：
立即学习“PHP免费学习笔记（深入）”；
- 打开一个
.php文件 → 右下角查看状态栏，确认显示的是PHP（不是Plain Text或HTML） - 若显示错误，点击该文字 → 选择
Grammar: PHP→ 勾选Save as Default for .php - 也可在配置中全局设置：
Config → Core → File Encoding下确保File Types中.php对应值为source.php
为什么不能只靠 autocomplete-php 或 php-integrator
这些包依赖语言服务协议（LSP）或外部 PHP 解析器，但前提是 language-php 已启用并正确解析语法结构。常见问题包括：
-
php-integrator-base报错Could not find grammar for source.php→ 本质是language-php未装或未生效 -
autocomplete-php不出提示 → 先确认language-php是否让 Atom 识别出函数定义区域（如function foo()被标为meta.function.php） - 所有 PHP 相关插件都要求 Atom 版本 ≥ 1.50；旧版 Atom（如 1.4x）可能因 API 变更导致包加载失败
/**
* 验证 language-php 是否生效的小技巧：
* 新建 test.php，输入以下内容，保存后观察关键词颜色：
*/
<?php
function hello($name): string {
return "Hello, {$name}!";
}
echo hello("World");
?>如果 function、string、echo 都有颜色，且 <?php 和 ?> 被识别为 PHP 开始/结束标记，说明已正常工作。最容易被忽略的是右下角语法切换后没点「Save as Default」——下次打开同名文件还会回到纯文本模式。
