最可靠方式是直接编辑config.json文件，需确保repositories为数组、首位禁用packagist.org、镜像URL末尾带/；Linux/macOS路径为~/.config/composer/config.json，Windows以composer config --global --list首行为准，改后必须执行composer clear-cache。

直接编辑 config.json 文件最可靠

命令行方式容易拼错键名或漏掉 type，而手动改文件能一眼确认结构是否合规。关键不是“能不能改”，而是改对哪几个位置、怎么写才不被 Composer 忽略。

• Linux/macOS 路径是 ~/.config/composer/config.json（Composer 2.0+ 优先读这个），不是 ~/.composer/config.json
• Windows 路径取决于 COMPOSER_HOME 环境变量，用 composer config --global --list 第一行输出才是真实路径
• 必须确保顶层有 "repositories" 字段，且它是数组（不是对象），内容形如：

  {"repositories": [{"packagist.org": false}, {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]}

• "packagist.org": false 必须放在第一位，否则 Composer 仍会尝试回源请求元数据
• url 值末尾必须带 /，少一个斜杠会导致请求路径变成 /composerpackages.json，返回 404

为什么改了 config.json 还不生效

常见现象是文件保存了、composer config -g repo.packagist 查不到输出，或者 composer update -vvv 日志里仍出现 packagist.org。这不是配置没写，而是被其他机制覆盖或跳过。

Pandas 配置文件报告生成器

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

下载

• 项目根目录存在 composer.json 且含 "repositories" 字段 → 全局配置自动失效，这是 Composer 的设计逻辑，不是 bug
• JSON 格式错误：多了逗号、用了中文引号、BOM 头、单引号、注释 → Composer 会静默跳过整个文件，不报错也不提示
• 缓存未清：旧的 packages.json 还在 ~/.composer/cache/repo/ 下，Composer 优先读缓存，根本不会发新请求
• 权限问题：文件属主不是当前运行用户（比如 CI 中用 sudo 写入，但构建跑在 runner 用户下）

系统级配置适用于多用户环境

在服务器、CI 或 Docker 镜像中，不能依赖单个用户的 ~/.config/composer/config.json，因为 PHP 实际执行用户（如 www-data、nginx）可能没有家目录或无法读取。

• 唯一被所有用户读取的路径是 /etc/composer/config.json（Composer 2.2+ 支持）
• 该文件结构不同："repositories" 是顶层对象，键名必须严格为 "packagist.org"，不能是 "packagist" 或 "aliyun"
• 正确写法示例：

  {"repositories": {"packagist.org": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}}

• 文件权限需为 0644，属主 root:root；用 sudo -u www-data composer config repo.packagist 验证是否生效

验证镜像是否真在用

别信 composer config -g repo.packagist 的输出，它只说明配置写进去了，不代表 Composer 正在用。真正有效的判断依据只有日志里的实际请求地址。

• 运行 composer update -vvv 2>&1 | grep "Downloading"，找类似 Downloading https://mirrors.aliyun.com/composer/packages.json 的行
• 如果看到的是 https://packagist.org/packages.json，说明要么配置没落地，要么被项目级 repositories 屏蔽，要么缓存没清
• 执行 composer clear-cache 后再试；若仍不行，检查 composer diagnose 输出中 Repo packagist.org: 后面的 URL 是不是你设的镜像地址

改配置本身几秒钟就完，但路径、JSON 结构、缓存、权限、作用域这五层叠加下来，一个环节错就全白忙——尤其 /etc/composer/config.json 和 ~/.config/composer/config.json 完全不是一回事，混用就会卡死。