composer name字段必须为全小写vendor/package格式，否则validate直接报错；psr-4命名空间键须以双反斜杠结尾，路径值推荐以/结尾；composer.lock必须提交且仅用install，禁用update。
团队用 Composer 必须统一 name 字段格式、autoload.psr-4 配置方式和 composer.lock 管理流程，否则成员本地 composer install 会装出不一致的依赖，CI 构建失败率陡增，类加载错误在上线前根本暴露不出来。
composer.json 的 name 字段必须是 vendor/package 全小写格式
这不是风格建议，是硬性校验规则：composer validate 会直接拒绝含大写字母、下划线或单段名的 name。比如 "myproject" 会被补成 "root/myproject"，而 root 不是合法 vendor，别人 require 时根本解析不到。
- vendor 必须与 Packagist 账号完全一致（如 GitHub 用户名
acme），不能是邮箱、域名或项目代号 - package 部分只允许 ASCII 小写字母、数字、短横线（
-），禁止_、.、空格、@等字符 - 常见错误：目录叫
LaravelApiClient，运行composer init --name没输全，结果生成"root/laravelapiclient"—— 这个包永远发不到 Packagist，也别想被团队其他成员正确 require
PSR-4 命名空间必须显式声明且末尾带双反斜杠
别信 composer init 自动生成的 autoload.psr-4，它把 acme/json-helper 转成 "Acme\JsonHelper\": "src/" 是机械驼峰，但你的代码里如果写了 namespace App\ 或 MyName\JsonHelper，自动加载器就永远找不到类。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间键必须以
\"结尾（如"Acme\JsonHelper\"），少一个反斜杠或写成"Acme\JsonHelper"都会导致匹配逻辑崩坏 - 路径值推荐以
/结尾（如"src/"），避免和同名文件冲突；绝对不能以/src/开头（会被当绝对路径报错） - 改了
name或autoload.psr-4后，必须立刻删掉vendor/和composer.lock，再跑composer dump-autoload -o，否则旧映射还在vendor/composer/autoload_psr4.php里生效
composer.lock 必须提交、install 必须替代 update
composer.lock 是环境一致性的唯一事实来源，不提交它，等于把“依赖版本”交给每个开发机的随机网络和缓存决定。
- 所有成员日常只允许执行
composer install，禁止composer update—— 后者会绕过 lock 文件重算依赖树，极易引入未测试的版本 - CI/CD 流水线必须用
composer install --no-dev --optimize-autoloader，跳过 dev 依赖，启用优化加载器 - 升级依赖必须由专人操作：先
composer update vendor/package（指定包），测通后提交新composer.lock，再通知团队同步install
本地 path 仓库测试时 name 必须与实际路径严格对齐
用 "type": "path" 本地调试私有包时，name 字段不是随便写的——Composer 会拿它和 repositories.path.url 下的目录结构做校验，不一致就直接拒绝安装。
- 例如
"name": "acme/json-helper"，对应 path 仓库必须是../json-helper，不能是../acme-json-helper或../json_helper - 路径中若含点号（如
my.tool），包名应转为my-tool/tool，而非照搬目录名 - 验证方式很简单：在项目根目录执行
composer require acme/json-helper:dev-main，能成功安装才说明 name + path + autoload 三者真正对齐
最常被忽略的是：改完 name 后，没同步更新 autoload.psr-4 键、PHP 文件里的 namespace 声明、以及所有已发布的文档或 README 中的 require 示例——这些地方一旦脱节，新人 clone 项目第一天就会卡在 Class not found。
