“Invalid version string”错误由composer.json中require、require-dev或config.platform字段的非法版本字符串引发，如"dev-master-beta"、"8.1"、"dev-main"等，需严格遵循SemVer 2.0规范，运行composer validate可精确定位错误行。
“Invalid version string”错误不是镜像问题，也不是缓存问题，而是composer.json里某处版本写法直接违反Composer的正则校验规则——改错就立刻好，换源或重装全无效。
composer.json里哪些字段会触发Invalid version string
报这个错时，Composer根本没开始下载包，它在解析阶段就卡住了。重点盯这三个位置：
-
require和require-dev中的包版本号，比如"monolog/monolog": "dev-master-beta"—— 连字符后没接点分隔的预发布标识，直接被拒 -
config.platform.php写成"8.1"或"8"—— 必须是完整 SemVer，如"8.1.0"或"8.1.*" - 私有仓库
repositories里package.version填了"dev-main"或"HEAD"—— 分支名不是版本字符串
运行 composer validate 是最快定位方式，它会指出具体哪一行、哪个键值非法。如果 validate 通过但 install/update 报错，就只查上面三项。
哪些版本写法绝对不能用
Composer 2.2+ 的版本解析器按硬正则匹配，以下写法哪怕只差一个字符都会失败：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"1.2.*"：已被彻底弃用，必须改用"^1.2"或"~1.2.0" -
"latest"、"stable"、"master"：这些是 Packagist 筛选词或 Git 分支名，不是合法版本字符串 -
"v1.2.3"：前缀v不属于 SemVer，会被当成非法字符 -
"1.2.3-rc1"：预发布标识必须用点分隔，正确是"1.2.3-rc.1" -
"dev-feature/login"：路径分隔符/不被接受，应改为"dev-feature-login" -
"1.2.3-custom.1"：自定义后缀仅允许alpha、beta、rc、dev开头，custom不在白名单内
分支、别名、预发布版本怎么写才合法
开发分支和预发布版本不是随便拼的，有明确语法边界：
- 分支必须带
dev-前缀，如"dev-main"、"dev-feature-auth"；写成"main"或"feature/auth"都非法 - 别名只在
repositories.type: package场景下有效，且version字段必须是"dev-main as 2.0.0"这种格式 ——as前后要有空格，右边必须是合法 SemVer（不能是"2.0.x-dev"，得是"2.0.0"或"2.0.0-dev"） - 预发布版本只能用连字符 + 字母开头标识，后续用点分隔纯数字/字母，如
"1.2.3-alpha.1"、"1.2.3-hotfix"；"1.2.3-20240501"或"1.2.3-my_fix_v2"都非法
镜像源对Invalid version string完全无影响
镜像只加速下载，不参与版本字符串校验。如果你换了阿里云镜像后还报这个错，说明问题不在网络或源，而在本地 composer.json。特别注意：
-
composer config -g repos.packagist这类全局镜像配置，对validate和install阶段的语法检查毫无作用 - 某些 IDE 插件或编辑器自动补全会插入
"dev-master"这类旧式写法，务必手动核对 - CI 流水线里如果用了
--no-interaction，错误提示可能被截断，建议加-v参数看完整堆栈
真正容易被忽略的是：版本字段一旦出错，Composer 就不会读取后续配置，所以即使你其他地方都配对了，只要有一处 version 写崩，整个命令就停在第一行解析上。
