PHPStorm中composer.json无键名提示，根本原因是未识别为Composer项目上下文：需确保项目根目录存在有效composer.json、已启用Composer支持、文件未被标记为Excluded，新建后还需手动触发Enable Composer support。
Composer.json 编辑时没有键名提示
这是最常见现象：打开 composer.json，输入 "requi" 按 Ctrl+Space 却没补全 "require"。根本原因不是插件没开，而是 PHPStorm 没识别出这是 Composer 项目上下文。
确认以下三点：
- 项目根目录下存在有效的
composer.json（哪怕内容为空对象{}） -
File → Settings → Languages & Frameworks → PHP → Composer中已勾选 Enable composer support -
composer.json文件本身未被标记为 “Excluded”（右键文件 → Mark as Plain Text 或 Remove exclusion）
如果刚新建了 composer.json，手动点击右上角灯泡图标或按 Alt+Enter，选择 Enable Composer support 才会触发初始化。
依赖包名不自动补全，或补全列表为空
输入 "monolog/mon" 没弹出 monolog/monolog，说明 PHPStorm 没连接到 Packagist 元数据源，或本地缓存未更新。
立即学习“PHP免费学习笔记（深入）”；
这不是网络问题，而是配置缺失：
- 确保
Settings → Languages & Frameworks → PHP → Composer中的Composer executable路径正确（如/usr/local/bin/composer），且该命令能执行composer show -N返回包列表 - 首次启用支持后，PHPStorm 会后台拉取 Packagist 的包索引，需等待右下角出现 Indexing completed 提示
- 若长期无响应，可手动触发：在
composer.json中任意位置按Ctrl+Space，选择 Reload package list
注意：require-dev 下的包默认也参与补全，无需额外设置。
类名无跳转、无参数提示，vendor 目录灰显
写了 use Monolog\Logger;，但 Logger 无法 Ctrl+Click 进入，或调用 new Logger() 时没构造函数参数提示——这和 Composer 配置无关，是自动加载索引失败。
关键动作只有两个：
- 必须先在终端运行
composer install或composer dump-autoload，确保vendor/autoload.php存在且可执行 - 右键项目根目录 → Reload project from composer.json（不是右键
vendor目录！）
如果 vendor 目录被标为 Excluded（常见误操作），右键它 → Mark Directory as → Cancel Exclusion，再 reload 一次。
PHP_CodeSniffer 检查不触发，或报错“Class not found”
想用 PHPCS 检查 composer.json 语法或依赖版本写法，但设置里开了却没反应——因为 PHPCS 和 Composer 是两套系统，不能互相替代。
要让 PHPCS 对 Composer 相关文件生效，得靠项目级配置：
- 在项目根目录放
phpcs.xml，内容至少包含：<rule ref="Composer"></rule>
（前提是已安装squizlabs/php_codesniffer并启用了 Composer 标准） - 或者更直接：用
composer require --dev dealerdirect/phpcodesniffer-composer-installer，它会自动注册 Composer 自身的 sniff 规则 - 检查
Settings → Languages & Frameworks → PHP → Code Sniffer的Path to phpcs是否指向vendor/bin/phpcs（推荐），而非全局安装路径
别指望 PHPStorm 自动识别 composer.json 的语义错误；它只做基础 JSON 校验，深度规则必须靠 PHPCS + 显式配置。
真正卡住人的地方，往往不是“怎么配”，而是“配完没反应时，该看哪一行日志、该点哪个菜单”。比如 vendor 灰显却不报错，大概率是漏了 reload 步骤；composer.json 补全失效，八成是文件被 exclude 了——这些细节比路径填对更重要。
