根本原因是全局配置（如composer config --global）无法纳入Git版本控制、不被CI识别、不可追溯且无法按项目差异化；必须将repositories和platform等配置写入项目级composer.json，并配合钩子校验、CI强制验证及脚本标准化，实现可审计、可复现、跨环境一致的配置管理。

团队里 Composer 配置不一致，根本原因不是没人配，而是配法错了——composer config --global 或本地改 ~/.composer/config.json 这类操作，注定无法同步、不可追溯、CI 会失败。

为什么不能用 composer config --global 同步源和平台配置

全局配置写死在个人机器上，对 Git、CI、新成员都不可见。CI 流水线（比如 GitHub Actions）压根没读这个文件，一跑 composer install 就 fallback 到 packagist.org，私有包直接报 Could not find package。

• composer config --global repositories.xxx 只改 ~/.composer/config.json，不进版本库，别人 clone 下来照样失效
• platform 配置写在全局里，无法按项目差异化（A 项目要 PHP 8.1，B 项目还在 7.4）
• 分支策略失效：dev 分支想用 snapshot 源，main 用 release 源——全局配置做不到动态切换
• 新人第一次 composer install 就卡住，还得翻 Wiki 手动配，违背“开箱即用”原则

必须把 repositories 和 config 写进项目级 composer.json

这是唯一能被 Git 跟踪、CI 自动识别、所有成员开箱即用的方式。Composer 会优先读取项目根目录的 composer.json，覆盖默认行为。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 私有 Packagist 源示例：

  {
    "repositories": [
      {
        "type": "composer",
        "url": "https://pkgs.internal.company.com"
      },
      {
        "type": "packagist.org",
        "url": "https://packagist.org"
      }
    ]
  }

  注意：私有源放前面，且显式声明 packagist.org 作为兜底（否则默认启用会被跳过）
• platform 统一 PHP 版本："platform": {"php": "8.1.0", "ext-gd": "1.0"} —— 它只影响依赖解析，不装扩展，但能防止锁进不兼容的包
• 禁用 packagist.org 默认行为？不行。必须显式保留它，或确保所有包都能从私有源命中，否则 composer update 会静默失败

如何让 composer.json 修改本身也受控

光写进去还不够，得防手误、防绕过、防格式混乱。靠人盯不如靠工具链自动卡点。

• Git 提交前加 .git/hooks/pre-commit 钩子：运行 composer validate --no-check-publish 校验 JSON 合法性；再跑 composer update --dry-run 看是否有人改了 require 却没更新 composer.lock
• CI 中强制执行：composer validate --strict + composer normalize --dry-run（需提前 composer require --dev composer-normalize）
• 脚本统一化：在 scripts 里定义 "cs-fix": "php-cs-fixer fix"，所有人只跑 composer cs-fix，不记路径也不拼错命令
• 禁止直接改 composer.json 的 require 字段？不现实。但可以要求新增依赖必须走 composer require --no-update，集中 review 后再 composer update 并提交新 composer.lock

真正难的不是写几行 JSON，而是让每个 composer.json 改动都可审计、可复现、可跨环境生效——这需要把配置当成代码管，而不是当成个人偏好设。