禁用 Packagist 官方源需设 "packagist": false 并显式声明镜像仓库，仅改 repo.packagist URL 不等于禁用；禁用后所有依赖（含间接依赖）必须在镜像中存在，否则解析失败。
禁用 Packagist 官方源 ≠ 换镜像，这是两件事
很多人以为执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就是“禁用官方源”，其实不是——它只是把官方源替换成镜像地址，packagist.org 依然在生效列表里，只是 URL 变了。真要禁用，必须让 Composer 彻底忽略 packagist.org 这个内置仓库，否则一旦镜像不可用（比如维护、DNS 异常），composer install 仍会 fallback 到官方源并卡住或失败。
关键区别在于：
-
repo.packagist配置只改 URL，不改变“是否启用”这个开关 - 真正禁用靠的是
"packagist": false或"packagist.org": false，且必须写在项目级composer.json顶层或repositories数组首位 - 命令行无法通过
config命令关闭这个开关，composer config --unset repo.packagist或--unset repos.packagist都只是删字段，不等于禁用
如何正确禁用 packagist.org 并只走中文镜像
必须分两步：先关掉默认源，再显式声明镜像为唯一可用仓库。不能只改 repo.packagist，也不能只在 repositories 里加一条镜像 URL。
操作步骤如下：
- 编辑项目根目录下的
composer.json，在顶层添加"packagist": false（注意没有.org，大小写敏感） - 在
repositories数组最前面插入一个对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 确保
repositories是数组格式（不是对象），且{"packagist": false}不在里面——它是独立的顶层键 - 删掉旧的
composer.lock和vendor目录，再运行composer install
错误写法示例："repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}] —— 缺少 "packagist": false，packagist.org 仍隐式启用"packagist.org": false —— Composer 2.2+ 才支持，老版本不识别，建议统一用 "packagist": false
为什么换完还报 “Could not find package”
禁用后所有包都必须能从你声明的镜像中获取，但阿里云等中文镜像并非 100% 实时同步 packagist.org 全量数据，尤其新发布、带特殊约束或非稳定版本的包可能延迟数小时甚至缺失。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见触发点：
- 依赖里用了
dev-master或dev-feature/x分支，镜像通常不缓存这类开发版 - 包名含特殊字符（如
@、/）或使用了私有命名空间，镜像未收录 - 你的
composer.json中minimum-stability设为dev，而镜像只提供stable版本元数据 - 镜像 URL 少了末尾
/，导致请求路径拼成https://mirrors.aliyun.com/composerpackages.json→ 404
临时验证方式：composer require monolog/monolog --no-install -vvv，滚动日志里找 Downloading https://mirrors.aliyun.com/composer/ 开头的行——没出现就说明没走镜像。
全局配置和项目配置冲突时以谁为准
Composer 查源顺序固定：环境变量 > 项目级 composer.json > 全局 ~/.composer/config.json。只要项目 composer.json 里有 "packagist": false，全局的 repo.packagist 设置就完全失效，哪怕它指向镜像地址也没用。
排查方法：
- 运行
composer config repo.packagist（不加-g），看输出是否为空或报错 —— 若有值，说明项目级覆盖了全局 - 运行
composer config -g repo.packagist，确认全局是否还残留旧镜像配置（避免误判） - 检查是否有
COMPOSER_REPO_PACKAGIST环境变量：env | grep COMPOSER_REPO_PACKAGIST，有则必须unset后再试
最容易被忽略的是：禁用 packagist.org 后，所有间接依赖（比如由 laravel/framework 引入的 symfony/*）也必须存在于你指定的镜像中，否则解析直接中断——这不是网络问题，是元数据缺失。
