Composer中config命令针对单独仓库地址（repositories）的修改（命令演示）-composer-PHP中文网

必须加--add，否则composer尝试赋值不存在的键会静默失败；--add确保将仓库配置以数组形式追加到repositories，避免覆盖误删，且url须为合法json、末尾带/，type必须正确匹配服务类型。

composer中config命令针对单独仓库地址（repositories）的修改（命令演示）

composer config --add repositories.xxx 为什么必须加 --add

不加 --add 直接执行 composer config repositories.myrepo type composer，Composer 会尝试给 repositories.myrepo 这个键赋值，但该键默认不存在，结果是静默失败或报错（取决于版本），根本不会新增仓库条目。

正确做法是显式用 --add 告诉 Composer：“我要往 repositories 数组里塞一条新记录”。它会自动把仓库配置转成数组格式，即使原来没这个字段。

composer config --add repositories.myrepo '{"type":"composer","url":"https://my.repo/api/"}' —— 注意：单引号包裹整个 JSON 字符串，内部双引号保留
如果 myrepo 已存在，--add 会追加为数组新元素；不加则尝试覆盖，容易误删已有配置
URL 必须是合法 JSON 字符串，写成 '{"type":"composer","url":"https://my.repo/api"}'（缺末尾斜杠）会导致请求路径拼错，静默失效

全局 vs 项目级 config 修改 repositories 的优先级差异

项目根目录下只要存在 composer.json 并含 "repositories" 字段（哪怕空数组），全局配置里的 repositories 就完全不生效。这是硬性规则，不是“叠加”或“fallback”。

也就是说：composer config -g repositories.myrepo ... 在有项目级 repositories 时等于白配。

Discussion Composer

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

下载

全局配置写入 ~/.composer/config.json，影响所有项目（除非被项目级覆盖）
项目级配置通过 composer config repositories.xxx ... 直接写进当前 composer.json 的 repositories 字段
项目级永远优先；想验证是否生效，直接 cat composer.json | grep repositories 看内容

repo.packagist 配置键名和 type 缺失导致镜像不生效

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后发现没换源？大概率是这三个坑之一：

键名写成 repos.packagist 或 repository.packagist —— 正确只能是 repo.packagist（单数，无 s）
漏掉 composer 这个 type 参数，命令变成 composer config -g repo.packagist https://...，结果存进无效字段
URL 少了末尾 /，比如写成 https://mirrors.aliyun.com/composer → 请求路径变成 https://mirrors.aliyun.com/composerpackages.json，404

验证方式不是看 composer config -g repo.packagist 输出，而是跑 composer diagnose，检查 Repo packagist.org: 行是否显示你设的地址。

私有仓库 type 配错导致 Could not find package

把一个 Satis 或 Private Packagist 地址配成 type: vcs，Composer 就会去按 Git 协议 clone，而不是发 HTTP 请求查 packages.json。结果要么 404，要么卡住，最后报 Could not find package —— 这错误信息毫无指向性。

type: composer → 对应提供 packages.json 的 HTTP 服务，URL 必须以 / 结尾
type: vcs → 对应 Git/SVN/Hg 地址，要求仓库根目录下有合法 composer.json，且打过 tag 或有 version 字段
私有 GitLab 包仓库若启用了 Composer 支持（如 GitLab Package Registry），仍要用 type: composer，不是 vcs

最容易被忽略的是：就算只写了自定义源，只要没关 "packagist.org": false，Composer 仍会先去官方源查一遍同名包，可能装错版本，还查不出原因。