私有包版本约束写法与公开包一致，但必须先在repositories中正确定义源（如"type": "vcs"、"url"完整可克隆），否则composer直接报“could not find package”而非版本不满足；分支需写"dev-main"等精确标识，^/~约束对type: package无效，且需确保tag已推送、元数据缓存已清。
composer.json里怎么写私有包的版本约束才生效
私有包的版本约束写法和公开包完全一致，但前提是它已在repositories中正确定义；否则 Composer 会直接跳过解析，报错“could not find package”，而不是“版本不满足”。
常见错误是把私有包当公开包用：比如写了"myorg/utils": "^1.2"，但composer.json里没配repositories，或配了却漏掉"type": "vcs"或"url"字段。
- 必须显式声明仓库类型：
"type": "vcs"（Git）、"type": "package"（手动定义单个包）、或"type": "composer"（私有 Packagist 镜像） - Git 仓库 URL 必须可访问且含完整协议，如
"https://git.myorg.com/utils.git"；SSH 地址需确保密钥已配置，否则composer update会卡在认证环节 - 如果私有包用的是
dev-分支（如dev-main），版本约束必须写成"myorg/utils": "dev-main"，不能写"^1.0"——因为分支名不参与语义化版本比较 - 用
"type": "package"时，得手动列出所有可用版本+对应dist或source信息，此时"version"字段就是硬编码的标识符，^或~约束无效，只认精确匹配
为什么私有包加了^1.0还是不更新
不是约束没起作用，而是 Composer 拉取私有源时默认不刷新元数据缓存；它可能还在用几小时前的旧 tag 列表，导致composer update找不到你刚 push 的v1.0.5。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer clear-cache后再composer update myorg/utils，是最直接的验证方式 - Git 仓库下，确保新 tag 已
git push --tags，且 tag 名符合vX.Y.Z或X.Y.Z格式（Composer 默认只识别这两种） - 若用
"type": "composer"指向私有 Packagist，确认该服务已执行update命令同步了最新索引，否则前端显示有 v1.0.5，Composer CLI 却查不到 -
composer show -a myorg/utils能列出所有可选版本；如果输出里没有你要的版本，说明问题一定出在源端或缓存，不是约束语法问题
COMPOSER_REQUIRE环境变量对私有包有效吗
有效，但仅限于私有包已存在于当前repositories配置中；它不会自动注册新源，也不会绕过认证。
- 例如：
COMPOSER_REQUIRE='{"myorg/utils":"dev-feature"}' composer update，前提是myorg/utils已在repositories里定义好，否则报Package myorg/utils not found - 如果私有 Git 仓库需要 SSH 密钥，
COMPOSER_REQUIRE不会改变认证行为——密钥仍需提前配置，否则 clone 阶段失败 - CI 场景中常用它临时覆盖版本，但注意：它会忽略
composer.json中原本的require字段，包括私有包的约束；所以本地开发慎用，容易误提交错误的 lock 文件
私有包依赖冲突时，composer why-not为什么查不到原因
因为composer why-not只分析已加载的依赖图，而私有包若未成功解析（比如仓库 URL 404、认证失败、tag 格式非法），根本进不了依赖解析阶段，自然不会出现在分析路径里。
这时要分两步排查：
- 先运行
composer diagnose，重点看repositories是否全部“OK”，有没有标红的Invalid repository - 再用
composer show myorg/utils --all，如果返回空或报错，说明问题卡在源发现环节，不是版本冲突；此时应检查网络、权限、URL 拼写、Git 服务器状态 - 只有
show能列出版本后，再跑composer why-not myorg/utils:1.0.5才有意义——它会告诉你哪个已安装包锁死了myorg/utils的版本上限
