为何composer create-project会安装Suphle依赖的旧版本？如何修复？

我开发了Suphle框架，同时做了一个面向用户的启动项目nmeri/suphle-starter，这个启动项目通过通配符版本*依赖Suphle。之前Suphle里有个带强制参数的命令，后来把参数改成了可选，但每次用启动项目创建新安装时，总是拉取旧版本，导致不带参数执行命令就失败。手动运行composer update后问题就解决了。我想知道：

1. 为什么无法自动检测到Suphle的最新版本？
2. 怎么在不硬编码最新版本标签的情况下修复这个问题？

启动项目的composer.json内容如下：

{
    "name": "nmeri/suphle-starter",
    "type": "project",
    "description": "Setup Suphle folder structure and provide workers or entry scripts for handling incoming requests",
    "autoload": {
        "psr-4": {
            "AllModules\\": "AllModules/",
            "AppModels\\": "AppModels/",
            "ModuleInteractions\\": "ModuleInteractions/"
        }
    },
    "config": {
        "sort-packages": true
    },
    "require": {
        "nmeri/suphle": "*"
    },
    "require-dev": {},
    "scripts": {
        "post-create-project-cmd": [
            "rr get-binary --location=./vendor/bin"
        ]
    }
}

一、无法检测到最新版本的原因 #

1. Composer缓存与Packagist索引延迟：create-project执行时，Composer会优先读取本地缓存的版本数据，如果Suphle的新版本刚发布，Packagist的版本索引可能还未同步到本地，导致拉取旧版本。
2. *通配符的稳定版本优先级：默认情况下，*只会匹配最新的稳定版本，如果你的Suphle新版本是预发布版本（带beta/rc标签），Composer会忽略它，继续拉取旧的稳定版。
3. create-project的版本锁定逻辑：创建项目时，Composer会生成composer.lock锁定当前安装版本，若启动项目模板未触发实时版本检查，就会固定在缓存的旧版本上。

二、不硬编码版本的修复方案 #

1. 使用语义化版本约束 #

如果Suphle遵循语义化版本规范，把依赖约束改成^x.y格式（比如^1.0），这样Composer会自动拉取该主版本下的最新小版本和补丁：

"require": {
    "nmeri/suphle": "^1.0"
}

这种方式既灵活又能保证版本兼容性，比*更可控。

2. 在post-create-project-cmd中自动更新依赖 #

既然手动composer update能解决问题，直接把这个步骤加入启动项目的脚本，让用户创建项目后自动更新Suphle到最新版本：

"scripts": {
    "post-create-project-cmd": [
        "composer update nmeri/suphle",
        "rr get-binary --location=./vendor/bin"
    ]
}

这个方案最直接，不需要用户额外操作。

3. 适配预发布版本（如果适用） #

如果新版本是预发布版，需要在启动项目的composer.json中明确允许拉取这类版本：

"require": {
    "nmeri/suphle": "*"
},
"minimum-stability": "beta", // 对应你的预发布版本等级，比如"rc"/"dev"
"prefer-stable": true // 优先选择稳定版，仅在需要时拉取预发布版

4. 强制Composer忽略缓存（用户侧临时方案） #

可以在文档中告知用户，若遇到版本未更新的情况，先执行composer clear-cache清除本地缓存，再重新创建项目。不过这是临时 workaround，建议优先从启动项目配置优化。

内容的提问来源于stack exchange，提问作者I Want Answers