composer 2.2+ 废弃 repo.packagist，必须改用 repositories.packagist.org 顶层键或 repositories 数组形式，否则静默忽略；需重生成 composer.lock、清缓存，并校验私有源 dist.type 为 zip/tar。

composer.json 里 repositories 配置键名失效了

Composer 2.2+ 开始，repo.packagist 这种写法会被静默忽略——你改了镜像地址却还在走 packagist.org，八成是这个原因。

常见错误现象：composer install 明明配置了国内镜像，却卡在 packagist.org 域名解析；composer config -g --list 看到配置存在，但实际没生效。

• 旧写法（1.x 风格，2.2+ 不保证兼容）："repo.packagist": {"url": "https://mirrors.aliyun.com/composer/", "type": "composer"}
• 新写法（推荐，2.2+ 官方明确支持）："repositories.packagist.org": {"url": "https://mirrors.aliyun.com/composer/"}
• 或者用数组形式（也兼容）："repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]
• 注意：repositories.packagist.org 是顶层键，不能嵌套在 repositories 数组里；两者混用可能导致被完全忽略

composer.lock 重生成后仍报错 Invalid package information

这不是锁文件坏了，而是私有源返回的 packages.json 格式不满足 Composer 2.x 要求——尤其是 dist.type 字段。

典型表现：composer update 跳过某个私有包，不报错也不安装；或直接报 Invalid package information。

• 检查私有源根目录下的 packages.json，搜索 "dist": { "type":，确认值是 "zip" 或 "tar"（2.x 只认这两个）
• Satis 用户需升级到 2.0+，并在 satis.json 中显式设置 "archive": {"format": "zip"}
• 旧版 Satis 返回的 "type": "pack" 已被 2.x 拒绝，无法绕过
• 改完后必须运行 composer clear-cache && composer update --no-install 验证元数据是否能正常拉取

升级后 composer install 卡住或直接崩

不是网络问题，大概率是 composer.lock 里残留了 1.x 特性字段（比如 content-hash 结构差异、插件相关元数据），导致 2.x 解析失败。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

别急着删 lock 文件——先验证是否真由 lock 引发：

• 运行 composer install --no-plugins --no-scripts -vvv，观察是否跳过插件后能继续
• 若仍崩，临时重生成 lock：rm composer.lock && composer update --lock（注意：这会重算所有依赖版本）
• 若项目依赖老插件（如 hirak/prestissimo），composer diagnose 会高亮提示，此时应 composer remove hirak/prestissimo，而非降级 Composer
• 切勿执行 composer self-update --rollback——该命令根本不存在；唯一合法降级是 composer self-update --1，但仅限紧急救火

ThinkPHP 5.* 项目升级 Composer 后命令报错

ThinkPHP 5.* 本身不强依赖 Composer，但它的安装器 topthink/think-installer 与 Composer 插件 API 绑定紧密。升级到 Composer 2.x 后，旧版 installer 会因 API 不兼容直接失败。

错误现象：composer create-project topthink/think 报 Class ThinkInstaller\Plugin not found 或类似插件加载失败。

• 解决方案：更新 installer 本身，运行 composer global require topthink/think-installer:^2.0
• 确认框架版本不变——这只是补丁层兼容，不影响 thinkphp/framework 的实际版本
• 若全局 require 失败，说明本地 Composer 全局路径权限异常，可改用项目级安装：composer require topthink/think-installer:^2.0 --dev
• 升级后务必测试 composer update 和 composer dump-autoload 是否正常触发自动加载逻辑

最常被忽略的是：镜像源配置改完没清缓存，composer.lock 没重生成，私有源 dist.type 没校验——三者叠加，问题就变成“怎么都试不对”。