扩展包require字段应使用语义化约束而非精确版本，如"php": "^8.1"、"symfony/console": "^6.4 || ^7.0"，禁用dev-main等非稳定版本；依赖设下限如"^3.0"而非锁死版本，避免下游冲突。
composer.json 里 require 字段怎么写版本号才安全
扩展包的 composer.json 不是“能装上就行”，它定义的是别人用你包时的兼容边界。写错一个符号，下游项目就可能因依赖冲突直接构建失败。
必须用语义化约束，而不是精确版本：
-
"php": "^8.1"—— 允许 PHP 8.1.x 到 8.99.99，但不跨到 9.0；写成"php": "8.1.0"会卡死所有小版本升级，下游 CI 很容易崩 -
"symfony/console": "^6.4 || ^7.0"—— 明确支持两个主版本，避免单写^6.4导致 Symfony 7 用户无法安装 - 不要在
require里写dev-main或1.0.x-dev—— 这些是非稳定版本，别人composer require你的扩展包时默认被拦住（minimum-stability: stable）
扩展包自身依赖要不要锁版本
不要在扩展包的 composer.json 里用精确版本（如 "monolog/monolog": "3.5.0"），这是反模式。
原因很实际：你锁死了，下游项目如果已依赖 monolog/monolog: 3.6.0，Composer 就会报冲突，哪怕 3.5.0 和 3.6.0 完全兼容。正确做法是只设下限：
-
"monolog/monolog": "^3.0"—— 表示“我至少需要 3.0.0，更高也行” - 若你代码用了 3.5.0 才加的 API，那就写
"^3.5"，别贪图“最新”而写^4.0 - 测试时用
composer update --with=monolog/monolog:3.6.0验证兼容性，而不是靠锁版本假装安全
如何让别人能装 dev 分支或预发布版
如果你的扩展包还在开发中，想让合作者试用 dev-main，不能只改自己包的 version 字段，还得配合 Packagist 设置和下游配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
三件事缺一不可：
- 本地
composer.json的version字段必须是"dev-main"或"1.0.x-dev"（不能是"1.0.0"，否则没 tag 就找不到） - Packagist 项目页要开启 “Auto-update” 并关联对应 Git 仓库，否则
dev-main不会被索引 - 下游项目装的时候得显式声明稳定性：
composer require your-vendor/your-pkg:dev-main --stability=dev，或者临时配composer config minimum-stability dev（仅限测试环境）
为什么 require-dev 里的版本可以更激进
require-dev 是给扩展包自己开发用的，不影响下游项目，所以可以放宽限制来提前暴露问题。
比如你用 PHPUnit 写测试：
-
"phpunit/phpunit": "^10.0"—— 允许跑在 PHP 8.1+，但不强制下游项目也装 PHPUnit - 甚至可以加
"friendsofphp/php-cs-fixer": "^3.14"这类工具，它们只在composer install --dev时才装 - 注意：不要把
require-dev里的包挪到require—— 曾有扩展包误把phpstan/phpstan写进require，导致所有用户都得装静态分析器才能composer install
最常被忽略的一点：扩展包的 composer.json 里没写 autoload 规则，别人 require 后根本没法自动加载你的类。哪怕版本全对，也会报 Class not found —— 这不是版本问题，是配置缺失。
