composer_home环境变量是唯一生效方式,设则强制使用、不设则回退默认路径(linux/macos为~/.composer,windows为%appdata%\roaming\composer);必须设绝对路径、手动迁移auth.json等文件并重装全局包,且需重启终端验证echo $composer_home与composer config --global home输出一致。

COMPOSER_HOME 环境变量是唯一生效方式
Composer 不读取你“想放哪”的配置,它只认 COMPOSER_HOME 环境变量的值。设了就用这个路径,不设就 fallback 到默认位置(Linux/macOS 是 ~/.composer,Windows 是 %APPDATA%\Roaming\Composer)。不存在“配置文件路径可单独改”的选项——auth.json、config.json、缓存、全局插件、vendor/bin 全部跟着它走。
Linux/macOS 设置后必须 source 或新开终端
只运行 export COMPOSER_HOME="/my/composer" 是临时的,关掉终端就失效。真正生效要写进 shell 初始化文件:
- 追加到
~/.zshrc(macOS Catalina 及以后默认)或~/.bash_profile(旧版 macOS/Linux) - 执行
source ~/.zshrc,或直接开新终端 - 验证:运行
echo $COMPOSER_HOME和composer config --global home,两者输出必须一致
Windows 上 setx 或 PowerShell 都要重启终端
在 CMD 里用 setx COMPOSER_HOME "D:\my-composer",或在 PowerShell 里用 [Environment]::SetEnvironmentVariable("COMPOSER_HOME", "D:\my-composer", "User"),都必须关闭并重新打开终端才能生效。不重启,composer 还是从旧路径读配置,auth.json 找不到就会静默失败,报错像 “Could not authenticate against github.com” —— 实际只是路径错了。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
旧数据不会自动迁移,漏这步就白配
COMPOSER_HOME 改了,Composer 不会帮你把老目录里的东西搬过去。必须手动复制:
- Linux/macOS:
cp -r ~/.composer/* $COMPOSER_HOME/,然后chmod 600 $COMPOSER_HOME/auth.json - Windows:把
%APPDATA%\Composer\*复制到新路径,注意auth.json权限(右键 → 属性 → 安全 → 当前用户要有完全控制权) - 全局包得重装:
composer global install或逐个composer global require xxx
最常被忽略的是 auth.json 权限和全局包重装——这两项不处理,后续所有需要认证或调用全局命令的操作都会出人意料地失败。










