Composer脚本别名必须通过script-alias配置实现，不能直接在scripts中定义别名；script-alias需与scripts同级，其值必须指向已注册的命名脚本（非内联命令），内联命令无法被script-alias引用。
Composer脚本别名必须通过 scripts + script-alias 双层定义
直接在 scripts 里写个新名字不会生效——Composer 不识别“别名”这个概念，它只认注册的脚本名。真要实现类似 composer dev-start 调用 php -S localhost:8000 -t public 的效果，得靠 script-alias 配置项中转。
常见错误是把别名当普通脚本写进 scripts，结果运行时报 Script not found 或静默失败。
-
script-alias必须放在composer.json根对象下，和scripts同级 - 键名是你要输入的“别名”，值是已存在的脚本名（不是命令）
- 被指向的脚本必须先在
scripts中正确定义，且类型为php、shell或env
script-alias 的值只能是已有脚本名，不能是原始命令
比如你写了 "dev-server": "php -S localhost:8000 -t public" 在 scripts 里，这属于“内联命令”，不是可被引用的脚本名。此时 script-alias 无法指向它——因为 Composer 不会为内联命令生成内部标识。
正确做法是把命令包装成一个可调用的 PHP 函数或独立文件：
- 新建
bin/dev-server.php，内容为<?php exec('php -S localhost:8000 -t public'); - 在
scripts中定义："dev-server": "php bin/dev-server.php" - 再在
script-alias中写："dev-start": "dev-server"
这样 composer dev-start 才能真正触发执行。
别名不支持参数透传，需要手动处理
运行 composer dev-start --port=8080，参数默认不会传给底层命令。Composer 的 script-alias 是纯名称映射，不解析或转发 CLI 参数。
如果需要动态端口、环境等，有两条路：
- 改用
symfony/console写完整命令行工具，在scripts中调用它（推荐） - 在包装脚本里读取
$_SERVER['argv']或getopt()解析参数，再拼接执行（简单场景可用） - 避免用
script-alias做复杂路由，它本质只是快捷方式，不是命令代理
Windows 下路径分隔符和 shebang 容易导致别名失效
如果你在 scripts 中调用的是 shell 脚本（如 ./bin/build.sh），在 Windows 上可能因 / 分隔符或缺少 .bat 后缀而报错 sh: command not found 或 The system cannot find the file specified。
跨平台别名更稳妥的方式是：
- 统一用 PHP 包装：写
bin/build.php，里面判断PHP_OS_FAMILY再调对应 shell 命令或 PowerShell 脚本 - 在
scripts中只写"build": "php bin/build.php" -
script-alias指向"b": "build"就完全不受系统影响
别名看着轻量，但一旦涉及路径、参数、跨平台，就得退回到脚本本身去控制细节——script-alias 只是入口，不是胶水。
