Drupal模块开发中drupal_set_message()不显示，主因是PhpStorm未正确识别PHP环境或Xdebug未连上Drupal运行上下文，该函数仅在完整HTTP请求中生效。
Drupal模块开发时，drupal_set_message() 不显示？检查 PhpStorm 的 PHP 语言级别和 Xdebug 配置
不是代码写错了，大概率是 PhpStorm 没把当前项目识别成 PHP 环境，或者 Xdebug 没连上 Drupal 的运行上下文。Drupal 的消息系统依赖完整的请求生命周期，IDE 里直接执行 drupal_set_message() 是无效的——它只在完整 HTTP 请求中生效。
- 确认
Settings > Languages & Frameworks > PHP中已设置正确 PHP 解释器（不能是空或“None”） - 检查
Settings > Languages & Frameworks > PHP > Debug：Xdebug 必须启用，且端口（默认 9003）与 Drupal 运行环境一致（如 Docker 容器映射、本地 Apache 配置） - 在 Drupal 模块中设断点后，用浏览器访问对应页面（比如
/admin/config），而不是右键 RunMyModule.php - 如果使用 Lando 或 DDEV，确保 PhpStorm 的
PHP > Servers配置中 Host 填的是服务名（如appserver），不是localhost
自动补全找不到 db_query() 或 entity_load()？开启 Drupal 插件并配置代码库路径
PhpStorm 默认不认识 Drupal 函数和类，补全失效不是 IDE 问题，是缺少语义索引源。Drupal 插件本身不自带核心 API 索引，得手动告诉它“代码在哪”。
- 安装官方
Drupal Support插件（JetBrains 插件市场搜即可），重启 PhpStorm - 在
Settings > Languages & Frameworks > PHP > Frameworks > Drupal中勾选启用，并填入 Drupal 核心路径（例如/path/to/drupal/core，不是整个 docroot） - 如果是 Drupal 8+，
entity_load()已废弃，补全不出来是正常的——改用\Drupal::entityTypeManager()->loadEntityByUuid()或->load()方法，补全依赖正确的命名空间和 use 声明 - 若用 Composer 管理依赖，确保
vendor/autoload.php被识别为 PHP Include Path（Settings > Languages & Frameworks > PHP > Include Paths）
调试 hook_form_alter() 时断点不触发？确认模块启用、缓存清空、钩子命名规范
断点“失灵”九成是钩子根本没注册成功，而不是调试器坏了。Drupal 的钩子机制对函数名、模块状态、缓存极其敏感。
- 检查模块是否启用：
drush pm:list | grep mymodule或后台/admin/modules页面确认状态 - 清空所有缓存：
drush cr（不是drush cc all，后者在 Drupal 8+ 已失效） - 函数名必须严格匹配：
mymodule_form_node_form_alter()中mymodule是模块机器名，node_form是表单 ID，大小写、下划线一个都不能错 - 如果表单 ID 含有破折号（如
webform-client-form-123），函数名中需转为下划线：mymodule_form_webform_client_form_123_alter() - 在
.module文件顶部加use Drupal\Core\Form\FormStateInterface;，否则 IDE 可能误报类型错误，干扰断点识别
运行 drush 命令报错 Command not found 或 Bootstrap failed？配置终端 Shell 和 Drush 全局路径
PhpStorm 内置终端默认不加载你的 shell 配置（如 ~/.zshrc），所以即使终端里能跑 drush，IDE 里也找不到。
立即学习“PHP免费学习笔记（深入）”；
- 进入
Settings > Tools > Terminal，把Shell path改成你实际用的 shell（如/bin/zsh或/bin/bash） - 确认 Drush 已全局安装：
which drush应返回路径（如/usr/local/bin/drush）；若用 Composer 全局安装，确保~/.composer/vendor/bin在$PATH中 - 在项目根目录运行
drush status，若提示Bootstrap failed，说明未识别 Drupal 根目录——在终端中先cd进 docroot（含index.php和autoload.php的目录）再执行 - 避免在
vendor/bin/drush上右键“Run”，它会脱离 Drupal 上下文；一律用终端输入完整命令
Drupal 开发里最耗时间的往往不是写代码，而是让 PhpStorm “相信”你正在写的确实是 Drupal 代码——路径对不对、插件启没启、缓存清没清、终端认不认识 Drush，漏掉任意一环都会卡住。这些配置项彼此不报错，但合起来就静默失效。
