检查语法包是否需要更新需手动进入Settings > Packages搜索包名，有Update按钮即存在新版本；更新后若文件仍不识别，需确认状态栏语法切换、config.cson文件类型映射及Tree-sitter兼容性。

如何检查语法包是否需要更新

Atom 不会自动提醒语法包更新，必须手动进设置页确认版本状态。打开 Settings > Packages，在搜索框输入包名（如 language-php），找到后看右侧显示的版本号——如果旁边有 Update 按钮，说明有新版本；若只有 Disable 或 Uninstall，代表已是最新版或已停更。

更新语法包的三种可行方式

官方推荐路径是通过 Atom 设置界面完成，但部分场景需手动干预：

• 点击 Update 按钮直接升级（适用于大多数活跃维护的包，如 language-nginx、language-vue-component）
• 若按钮灰显或点击无反应，先点 Disable 再点 Enable，强制重载语法定义（对因 Tree-sitter 切换导致 scope 错乱的包有效）
• 极少数包（如老旧的 language-proto）已停止维护，apm update 命令会报错 No versions available，此时只能手动替换 grammars/*.cson 文件或迁移到社区替代方案

更新后 PHP/Vue/Nginx 文件仍不识别？重点查这三处

语法包更新本身不保证文件立即高亮，常见断点不在版本号上：

• 右下角状态栏是否仍显示 Plain Text？必须手动点击切换为 PHP / Nginx / Vue Component
• config.cson 中的 core.fileTypes 是否被覆盖？例如 '.conf': 'source.nginx' 若被误删，.conf 文件即使装了 language-nginx 也不会自动触发
• 是否启用了 Tree-sitter 解析？新版 language-javascript-bundled 等包默认启用 Tree-sitter，其作用域名（如 support.function.js）和传统 TextMate 语法（entity.name.function.js）不兼容，旧语法主题 CSS 可能完全失效

为什么有些语法包“更新失败”却没报错

表面成功更新，但打开文件还是白字，问题往往藏在依赖链里：

• language-vue 更新后 .vue 文件 script 区块不亮？大概率是 language-javascript-bundled 没同步更新，导致 JS 部分解析失败
• language-protobuf 更新后数字常量高亮消失？检查 grammars/protobuf.cson 里的 scopeName 是否还匹配当前主题的 CSS 选择器（比如从 source.protobuf 改成了 source.proto）
• 执行 apm list --installed 发现包名带 -bundled 后缀（如 language-rust-bundled），这类包由 Atom 官方集成，不能用 apm install 覆盖，必须等 Atom 主版本升级

真正卡住的地方不是“怎么点更新”，而是更新后 grammar scope 是否被正确注入到编辑器上下文——光看包版本号没用，得用 Ctrl+Shift+P 执行 Editor: Log Cursor Scope 看实际输出。