composer要求用冒号分隔包名与版本号，如laravel/framework:9.52.7；错误写法@或=会导致“no matching version”；版本需真实存在且符合stability设置，可用composer show -a查看可用版本。
composer require 时怎么锁定具体版本号
直接在包名后面加 版本约束字符串，Composer 就不会去猜最新兼容版，而是严格按你写的装。比如你要装 Laravel 的 9.52.7，不是 laravel/framework，而是 laravel/framework:9.52.7。
常见错误是写成 laravel/framework@9.52.7 或 laravel/framework=9.52.7 —— 这两种都不认，会报 Could not find a matching version。
- 用冒号
:分隔包名和版本，这是唯一合法语法 - 版本可以是完整 tag（
9.52.7）、分支别名（dev-main）、提交哈希（dev-main#abc123），但后者需配合--prefer-source - 如果项目已存在
composer.lock，执行前最好先composer update --lock确保 lock 文件不冲突
安装旧版包却提示“no matching package found”
不是你写错了，大概率是那个版本根本没发布到 Packagist，或者被作者标记为 abandoned，又或者你的 minimum-stability 设置太高（比如设成了 stable，但目标版本只是 RC 或 beta）。
查清原因比硬试更快：打开 Packagist 页面，搜你要的版本号，看它是否存在、是否 stable、有没有被弃用提示。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 如果版本存在但状态是
RC，临时降级 stability：composer require laravel/framework:9.0.0-RC1 --stability=RC - 如果包已废弃（abandoned），Packagist 页面会显示替代包，强行装旧版可能引发运行时错误
-
composer show -a vendor/package能列出所有可用版本，包括 unstable 的，比盲猜靠谱
require 和 require-dev 中指定版本的行为差异
行为完全一致，区别只在依赖用途：运行时需要的放 require，开发期才用的（比如 PHPUnit、PHPStan）放 require-dev。但要注意——
- 如果你在
require-dev里装了一个带 runtime side effect 的包（比如symfony/var-dumper在生产环境被误用），它依然会被 autoload，只是不参与生产部署流程 -
composer install --no-dev会跳过require-dev里的所有包，哪怕你指定了精确版本也不会装 - 两个字段里若出现同一包不同版本（比如
require要 2.1.0，require-dev要 2.2.0），Composer 会报依赖冲突，必须手动协调
用 composer create-project 初始化项目时指定版本
不是在 create-project 后面加 @version，而是把版本号作为第三个参数传进去，格式是：composer create-project vendor/name project-dir version。
例如要初始化一个 Laravel 10.48.12 的新项目：composer create-project laravel/laravel myapp 10.48.12。漏掉第三个参数就会装 latest stable。
- 版本参数支持通配符，比如
10.48.*或^10.48，但注意create-project不解析^，它只做字符串匹配，所以推荐用明确版本号 - 如果指定的版本不存在，命令会失败并提示
Could not find package ... in a version matching ...，不会退回到最近可用版本 - 该命令默认会执行
composer install，所以最终生成的composer.lock就是你指定版本的快照，无需再手动 fix
版本号不是越新越好，也不是越旧越稳；关键是你能否验证它在当前 PHP 版本、扩展组合、已有依赖树下的实际行为。很多人卡在“明明写了版本号却装了别的”，问题往往出在 Packagist 数据滞后、本地 cache 没清、或者 stability 配置挡在中间。
