最可靠方式是用 lsp-mode 配合 intelephense；需确保 php 在 $PATH、项目根目录有 intelephense.json 配置、LSP 已启用且光标位于可解析符号上。
用 lsp-mode 跳转 PHP 定义最可靠
Emacs 原生不支持 PHP 符号跳转，必须依赖语言服务器。目前唯一稳定可用的是 lsp-mode 配合 intelephense（推荐）或 phpactor。不要尝试 etags 或 gtags，PHP 动态特性会让它们频繁失效。
关键点：
-
intelephense是闭源但免费的商业 LSP，对 Composer 项目、命名空间、Trait、动态调用识别最准 -
phpactor开源，但需额外配置 autoload 和 RPC 模式，新版本对 PHP 8.2+ 支持滞后 - 确保
php命令在$PATH中可执行，否则 LSP 启动失败，lsp-describe-session会报"server crashed"
lsp-find-definition 的触发方式和常见失败原因
默认绑定是 C-c C-d，但实际使用中容易按错或无响应——这通常不是快捷键问题，而是底层状态异常。
排查顺序：
- 确认当前 buffer 已被
lsp-mode启用：M-x lsp应显示LSP enabled for php-mode，否则运行M-x lsp手动开启 - 检查右下角 mode-line 是否出现
lsp图标；若显示lsp-busy却长期不动，大概率是intelephense初始化卡在扫描 vendor 目录，可在~/.emacs.d/intelephense/下删掉缓存目录重试 - 光标必须落在「可解析符号」上：函数名、类名、方法名本身（不能在括号内、字符串里、注释中），否则提示
No definition found
PHP 项目级配置必须写 intelephense.json
没有项目级配置，intelephense 默认只索引当前文件，跨文件跳转会全部失败。必须在项目根目录放一个 intelephense.json，内容至少包含：
{
"intelephense.environment.includePaths": [
"./vendor/autoload.php"
],
"intelephense.stubs": [
"php",
"json"
]
}
常见疏漏：
- 路径写成绝对路径（如
/home/user/project/vendor/autoload.php）——LSP 不认，必须相对项目根目录 - 漏掉
"php"stub，导致DateTime、array_map等内置函数无法跳转 - Composer 项目没生成 autoload，先运行
composer dump-autoload再启 Emacs
替代方案：不用 LSP 时的底线选择
如果因网络/权限/旧系统无法装 intelephense，可退到 xcscope + phpctags 组合，但仅适用于小型、无 Composer、无命名空间的脚本。
操作要点：
- 用
phpctags -R --php-kinds=+cfi --fields=+niaS生成tags文件（注意加-R递归，否则只扫当前目录） - 在 Emacs 中执行
M-x visit-tags-table指向该tags文件 - 跳转用
M-.（不是C-h .），光标停在函数名上再按 - 遇到
Class 'Foo' not found类型的定义缺失，说明phpctags未识别use语句或别名，此时只能手动打开对应文件
这种方案在 Laravel、Symfony 或含大量 __call / class_alias 的项目里基本不可用，只是应急手段。
