Composer更新过程中磁盘意外写满引发的配置文件损坏恢复指南-composer-PHP中文网

核心问题是缓存写入中断、权限残留与inode耗尽叠加；必须先停进程、再清缓存、最后重置配置，缺一不可。df -i use%≥95%即确认inode耗尽，需kill所有composer进程后执行composer clear-cache，并修复权限及repo.packagist配置。

composer更新过程中磁盘意外写满引发的配置文件损坏恢复指南

磁盘写满导致 Composer 配置损坏，核心问题不是文件被“改乱”，而是缓存写入中断 + 权限残留 + inode 耗尽三者叠加；必须先停进程、再清缓存、最后重置配置，跳过任一环节都可能让 composer install 反复失败。

df -i 显示 Use% 接近 100% 就别碰 composer install

报 No space left on device 却发现 df -h 还剩几十 GB？八成是 inode 耗尽。Composer 缓存目录（~/.composer/cache 或 %APPDATA%\Composer\Cache）里数万个小文件——每个 ZIP、每个 Git 子目录、每个哈希前缀都占一个 inode。APFS、Docker、某些云主机尤其敏感。

Linux/macOS：运行 df -i $(composer config --global cache-dir)，重点看输出里 Use% 是否 ≥95%
Windows：PowerShell 中执行 Get-PSDrive C | Select-Object Used,Free 辅助判断磁盘块是否真满，但不能替代 inode 检查
若 Use% 接近 100%，立刻停所有 composer 进程，否则 clear-cache 会卡死或删不干净

杀光进程后再跑 composer clear-cache

直接 rm -rf ~/.composer/cache 极危险：IDE 内嵌的 Composer、后台 php composer.phar、残留锁文件，都会导致删一半就中断，甚至损坏缓存索引。必须先清进程，再让 clear-cache 安全收尾。

Pandas 配置文件报告生成器

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

下载

查进程：ps aux | grep composer（Linux/macOS）或 tasklist | findstr composer（Windows）
杀干净：kill -9 $(pgrep -f "composer")（Linux/macOS），Windows 手动结束对应 PID
再执行 composer clear-cache —— 它会跳过被占用项、校验权限、只删无效/损坏/过期条目
留意输出：若提示 Permission denied，说明部分子目录属主不是当前用户（比如曾用 sudo composer），需先修复权限

配置文件没“损坏”，但镜像和缓存已失效

磁盘写满时 Composer 可能中途断在写 config.json 或缓存元数据上，结果就是 repo.packagist 字段错位、缓存快照残留旧镜像地址、或环境变量接管失效。这不是 JSON 语法错误，而是逻辑错配。

先确认全局镜像：composer config -g -l | grep repo.packagist，值不是 https://packagist.org 就得重设
恢复官方源：composer config -g repo.packagist https://packagist.org（注意字段名是单数 repo.packagist，不是 repos.packagist）
强制清缓存：composer clear-cache 是硬性前置步骤，否则旧镜像快照还在，install 仍会走错路
验证是否生效：composer require monolog/monolog --no-install -vvv，盯住日志里 Downloading https:// 的 URL 是否指向 packagist.org

vendor 目录重建前必须确认 composer.lock 状态

磁盘写满常伴随 composer.lock 写入中断，造成 JSON 结构破损、哈希字段缺失或换行符错乱。此时直接 rm -rf vendor && composer install 会失败，因为 Composer 拒绝读取损坏的 lock 文件。

先验证：composer validate —— 不联网、不读 vendor，500ms 内就能告诉你 lock 是否合法
若报 The lock file is not up to date：说明只是“过期”，跑 composer update --lock 对齐即可（只更新哈希和大小字段）
若报 JSON 解析失败：检查是否有 Git 冲突标记、BOM 头、Windows 换行符，可用 head -n 5 composer.lock | cat -A 查看不可见字符
真损坏且无 Git 历史？删掉 composer.lock，再 composer install（前提是 vendor 已清空，否则新版 Composer 会直接报错）

最易被忽略的是缓存路径权限残留和 repo.packagist 字段名拼写错误——前者让 clear-cache 静默跳过关键目录，后者让镜像设置完全失效。这两处不手动验证，重装十次也白搭。