Drupal插件已在PhpStorm 2023.3+中移除，应改用PHP Annotations+Composer autoload实现钩子提示，并通过标记源目录、重载项目、配置类型注解及正确标记settings.php为资源根来恢复功能。
Drupal 插件在 PhpStorm 2023.3+ 已被移除，别再找 Drupal 插件了
phpstorm 官方从 2023.3 版本起正式下架了内置的 drupal 插件（id: org.jetbrains.plugins.drupal），原因是 drupal 社区转向更通用的 php/composer 生态，且该插件长期未适配 drupal 9+/10 的钩子系统和新注解机制。你现在在 settings > plugins 搜索 drupal，只会看到“not found”或过期的第三方 fork——装了也大概率不识别 hook_entity_insert() 或 @hook 注解。
用 PHP Annotations + Composer autoload 实现钩子提示
Drupal 8+ 的钩子本质是约定命名的函数，IDE 无法静态推断，但可通过 PHPDoc 注解 + 手动索引补全。关键不是插件，而是让 PhpStorm 理解你的模块结构：
- 确保项目根目录有
composer.json，且已运行composer install（Drupal 核心和模块的autoload规则靠它驱动） - 在自定义模块的
.module文件顶部加标准 PHPDoc 块，例如：/** * Implements hook_help(). * * @param string $route_name * @param \Drupal\Core\Routing\RouteMatchInterface $route_match * @return string */
- 右键点击模块目录 →
Mark Directory as > Sources Root，否则 PhpStorm 不扫描其中的函数声明 - 触发索引：菜单栏
File > Reload project from Disk，然后等右下角索引进度条消失
手动配置 Drupal 核心类与服务提示（避免 ServiceNotFoundException 报红）
PhpStorm 默认不识别 \Drupal::service() 返回类型，导致 $node_storage = \Drupal::entityTypeManager()->getStorage('node') 后续调用无提示。解决方法是显式标注返回值：
- 在调用前加 PHPDoc：
/** @var \Drupal\node\NodeStorageInterface $node_storage */
- 或使用
ContainerInterface注入（推荐）：在控制器或服务类的__construct()中声明参数类型，PhpStorm 会自动关联entity_type.manager服务接口 - 确认
vendor/drupal/core/lib/Drupal/Component/DependencyInjection/Container.php已被索引（检查External Libraries > composer下有无报错）
钩子函数跳转失效？检查 settings.php 是否被误标为纯 PHP
如果点击 hook_form_alter() 跳不到定义处，大概率是 web/sites/default/settings.php 被标记成了普通 PHP 文件，而非 Drupal 配置上下文。这个文件里常含 $settings['hash_salt'] 等全局变量，但 PhpStorm 若没识别其 Drupal 属性，就不会把同名函数（如 mytheme_form_alter）纳入钩子候选。
修复方式：File > Project Structure > Modules > [你的项目名] > Sources，找到 web/sites 目录 → 右键 → Mark as > Resources Root；再打开 settings.php，顶部加一行：
<?php // @codingStandardsIgnoreFile - Drupal settings file，保存后重新索引。
立即学习“PHP免费学习笔记（深入）”；
真正卡住的地方往往不是插件有没有，而是路径标记、autoload 规则和 PHPDoc 的组合是否对齐——少一个环节，钩子就只是字符串，不是可跳转、可补全的 API。
