VS Code 中 composer.json 语法提示失效需配置官方 JSON Schema，即在 .vscode/settings.json 中添加 json.schemas 绑定 https://json.schemastore.org/composer，可实时标红字段错误、缺失必填项等，但包名存在性与平台兼容性仍需 composer validate 验证。
composer.json 文件语法提示失效？配 JSON Schema 就够了
VS Code 默认对 composer.json 没有字段级校验，拼错 require-dev 或漏写逗号只能靠肉眼发现。这不是插件没装全，是没绑定官方 JSON Schema。
在工作区的 .vscode/settings.json 中加这一段：
{
"json.schemas": [
{
"fileMatch": ["composer.json"],
"url": "https://json.schemastore.org/composer"
}
]
}
加完立刻生效：字段名标红、必填项提示、版本约束格式校验全都有。但注意：composer validate 仍不可替代——Schema 不检查包名是否真实存在、不验证 PHP 平台兼容性。
类名跳转标红、new 实例没提示？Intelephense 的 includePaths 没设对
PHP Intelephense 不会自动扫描 vendor/，它只认你明确告诉它的路径。写成 "./vendor/"（末尾斜杠）、vendor（缺点）、或绝对路径，都会让索引静默失败。
-
intelephense.environment.includePaths必须设为["./vendor"]（严格匹配，无斜杠，带点） - 必须已执行过
composer install或composer update，确保vendor/目录真实存在 - 改完设置后，必须关闭并重新打开整个 VS Code 窗口（不是重载窗口），否则 Intelephense 不会重建索引
- 如果项目用 symlink 连接
vendor（如 Docker 场景），确认 VS Code 启动时能访问到真实路径
为什么 dump-autoload -o 是必须步骤？
PSR-4 映射不是实时解析的。Intelephense 默认不递归扫描 vendor/ 全量文件（太慢），它依赖 composer dump-autoload -o 生成的 vendor/composer/autoload_classmap.php 这个“速查表”。
常见表现：
-
use语句能补全，但new SomeClass()标红 - 修改
composer.json的autoload段后，跳转依旧指向旧位置
只要改了自动加载规则，就运行一次：composer dump-autoload -o。别省这个 -o，它生成优化映射，比默认模式快得多。
PHP 版本不匹配会导致提示错乱
intelephense.environment.phpVersion 设错，不是简单“提示不准”，而是类型系统底层失准：8.1 下写的 random_bytes() 返回类型在 8.2 里变了，设低了会报错；设高了又会让 mysql_connect() 这类弃用函数逃过警告。
正确做法：
- 看
composer.json的config.platform.php或require.php，取最小支持版本 - 在工作区设置里配，别用全局设置，避免跨项目污染
- 执行
php -v确认 CLI 版本，和配置值严格一致
最易忽略的一点：VS Code 必须以含 composer.json 的目录为根打开——打开父文件夹或单个文件，Intelephense 就找不到 vendor/，所有配置都白搭。
