在 composer.json 中定义自定义命令本质是通过 "scripts" 字段配置脚本别名，供 composer run 调用；支持字符串、数组、对象形式，可复用、绑定事件、调用 PHP 脚本，实现项目内轻量自动化。
在 composer.json 中定义自定义命令，本质是通过 "scripts" 字段配置脚本别名，让 composer run（或旧版 composer run-script）能触发执行。它不创建全局 CLI 命令，而是为项目内部常用操作提供快捷入口。
在 scripts 中定义命令别名
把命令写进 composer.json 的 "scripts" 对象里，键名就是你调用的别名，值可以是字符串命令、数组（多条顺序执行）、或对象（支持事件钩子等高级用法）。
- 最简形式：直接写 shell 命令字符串（支持 PHP 内置命令、已安装的二进制文件、或相对路径脚本）
- 推荐用数组形式，更清晰且兼容性更好，尤其含空格或管道时
- 命令中可用
$COMPOSER_BIN_DIR、$COMPOSER_HOME等环境变量（Composer 自动注入）
示例：
"scripts": {
"dev:clear": [
"php artisan config:clear",
"php artisan cache:clear"
],
"test:unit": "vendor/bin/phpunit --testsuite=Unit",
"build:dist": "npm install && npm run build"
}
执行自定义命令
定义后，用 composer run <script-name> 执行（Composer 2.2+ 推荐语法），旧版本可使用 composer run-script <script-name>。
-
composer run dev:clear→ 清除 Laravel 配置与缓存 -
composer run test:unit→ 运行单元测试 - 加
--no-ansi、-v等参数可透传给底层命令
注意：脚本默认在项目根目录运行，路径无需额外切换。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
支持事件钩子与动态行为
除了手动运行，scripts 还可绑定到 Composer 生命周期事件（如 post-install-cmd、post-update-cmd），实现自动化。
- 例如自动执行前端构建：
"post-install-cmd": ["@build:dist"] - 用
@xxx可复用已定义的 script 别名 - 支持条件判断（需配合插件或自定义 PHP 脚本），纯 JSON 不支持 if/else
进阶：用 PHP 脚本封装复杂逻辑
当命令逻辑较重（比如读取配置、交互式确认、异常处理），建议写成独立 PHP 文件，在 scripts 中调用：
"scripts": {
"deploy:check": "php scripts/check-deploy.php"
}
scripts/check-deploy.php 可使用 Composer 的 autoload，也能访问 getenv('COMPOSER_ROOT') 等上下文信息。这样比长命令行更可维护、易调试。
基本上就这些。scripts 是 Composer 最实用的轻量自动化机制，不复杂但容易忽略它的组合能力和执行上下文。
