直接修改 composer.json 不生效，必须配合对应命令：改 autoload 需 composer dump-autoload，改 require 需 composer install/update，改元数据需确保 json 合法且字段位置正确。

直接改 composer.json 文件本身不生效，必须配合对应命令触发解析、安装或重生成逻辑；手写容易错格式、错字段位置、漏联动操作，多数“改了没用”问题其实卡在没跑 composer install、composer dump-autoload 或校验失败。

改了 description 或 author 为什么 composer show 没变

这两个字段纯属元数据，不参与依赖解析或自动加载，改完只需保存文件即可被 composer show 读取——但前提是改对位置、JSON 合法、且你查的是当前工作目录下的文件。

• description 必须在顶层，不能塞进 require 或 config 里；写成 "description": "xxx"，不是 "desc": "xxx"
• author 必须是数组，哪怕只填一个人也要写成 [{"name": "张三"}]，写成对象 {"name": "张三"} 会导致 composer validate 报错
• 改完没生效？先运行 composer validate 确认 JSON 合法；再用 composer show your-vendor/your-name（注意 vendor/name 要和 name 字段一致）验证
• Packagist 页面还是旧的？它读的是你 git push 的 commit，不是本地文件。运行 git show HEAD:composer.json | grep -A 3 author 确认线上版本是否真含新内容

autoload 配了却报 Class not found

PSR-4 映射失效是最常见原因，问题几乎全出在路径或命名空间与实际文件结构不匹配，Composer 不会主动报错，只静默跳过。

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

• "psr-4": {"App\": "src/"} 要求：文件 src/Http/Controller.php 中必须声明 namespace AppHttp;（结尾带反斜杠），不能是 namespace App\Http; 或 namespace AppHttp
• 路径 "src/" 必须真实存在，且末尾必须有斜杠；写成 "src" 或 "./src/" 都会导致类文件路径拼错
• 改完 autoload 段后，必须手动运行 composer dump-autoload（可简写为 composer du），install 或 update 不会自动触发这步
• Windows 下路径用反斜杠不影响 Composer 解析，但建议统一用正斜杠，避免 IDE 或脚本处理异常

手写 require 后包没装进去

声明 ≠ 安装。composer.json 只是需求清单，不执行命令，vendor 目录不会变，autoload 也不会更新。

• 如果项目已有 composer.lock，仅改 require 后运行 composer install，它会按 lock 文件还原，**忽略你新加的包**；此时必须用 composer update vendor/package-name 或删 lock 后再 install
• 推荐用 composer require vendor/package-name 替代手写：它自动写入 composer.json + 执行 update + 刷新 autoload，一步到位
• 加开发依赖？务必加 --dev 参数，否则会进 require，导致生产环境多装无用包；例如 composer require phpunit/phpunit --dev
• 改了 require-dev 但 CI 报 command not found？确认 CI 脚本是否用了 --no-dev 参数——该参数会让 Composer 完全跳过 require-dev 里的包

name 字段写错的静默后果

name 看似只是个标识，但它影响 autoload 行为、包发布、甚至本地路径依赖解析；写错不会报错，但类加载、依赖安装可能随机失败。

• 必须是 vendor/name 格式，全小写、斜杠分隔、无空格；"acme/blog-api" ✅，"AcmeBlogApi" ❌，"blog-api" ❌
• 本地项目不想发包？可用占位名如 "local/mytool"，但绝不能留空或只写 "mytool"；否则 psr-4 自动加载器无法正确推导根命名空间
• 用 path 类型仓库 require 本地包时，如果被依赖方的 name 格式非法，Composer 会静默跳过该包，不提示、不报错、也不装
• 检查方式：运行 composer validate 会提示 name 格式错误；更隐蔽的问题得靠 composer show 输出的包名是否与你预期一致来反推

最常被忽略的其实是联动动作：改 autoload 必须 dump-autoload，改 require 必须 install/update，改元数据字段必须确保 JSON 合法且位置正确——没有哪一步能省，也没有哪个错误会大声告诉你“你忘了”。