where composer返回路径后，需运行echo %PATH%（Windows）或echo $PATH（macOS/Linux）确认该路径已加入系统级Path变量且无尾反斜杠，再新开终端验证；若未出现则手动添加并重启终端。
where composer 返回路径后，怎么确认它真被系统识别
PATH 没生效，where composer 就不会输出任何东西；但即使它返回了路径，也不代表 composer 命令能在任意目录运行。关键要看这个路径是否已写入系统级 Path 环境变量，且新终端已加载。
- 运行
echo %PATH%（Windows CMD）或echo $PATH（PowerShell / Git Bash），搜索输出中是否包含where composer返回的完整路径（比如C:\ProgramData\ComposerSetup\bin） - 如果没找到，手动把它加进「系统变量」里的
Path，注意末尾不能带反斜杠：C:\ProgramData\ComposerSetup\bin✅，C:\ProgramData\ComposerSetup\bin\❌ - 改完必须新开一个终端窗口——旧窗口的环境变量不会自动刷新
- Git Bash 用户额外验证：运行
which composer，若仍报command not found，说明 Windows 的Path没透传进来，需检查 Git Bash 是否以管理员权限启动，或尝试重启终端
composer config -g cache-files-dir 输出为空，说明缓存根本没启用
缓存路径配置错，不是变慢，而是完全不走缓存。常见表现是反复下载同一包、composer install 无明显提速、~/.composer/cache 目录存在但 files/ 子目录下空空如也。
-
composer config -g cache-dir只显示配置值，不可靠；必须用composer config -g cache-files-dir—— 它返回的才是 Composer 实际用于存储包文件的路径 - 如果输出为空，立刻补上：例如在 Linux/macOS 执行
composer config -g cache-files-dir ~/.composer/cache/files；Windows 上用composer config -g cache-files-dir %APPDATA%\Composer\Cache\files - 路径必须指向
files子目录，只配到cache父目录无效 - Windows 下避免路径含中文、空格或
%USERPROFILE%这类变量，Composer 会静默 fallback 到默认路径
path 仓库报 “Source path does not exist”，先别改配置，先查文件系统
这个错误和权限无关，是 Composer 在文件系统里压根找不到你写的那个目录。它不解析符号链接、不展开 ~、不处理大小写容错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 看报错里明确写的路径，比如
Source path ../my-pkg does not exist，立刻在项目根目录下执行dir ..\my-pkg（CMD）或ls -ld ../my-pkg（PowerShell/Linux/macOS） - 路径必须是相对项目
composer.json的真实路径，不能从子目录执行命令再用../往回跳——基准永远是项目根 - Linux/macOS 区分大小写：
MyPkg≠mypkg；Windows 虽不区分，但某些 PHP 版本会因大小写不一致静默失败 - 路径中禁用
~、$HOME、file://，必须用绝对路径（如C:/dev/my-pkg）或纯相对路径（如../my-pkg） - 目标目录下必须有合法的
composer.json，且里面name字段格式为vendor/name（小写字母 + 短横线），不能是Vendor/Name或vendor_name
全局镜像配置写了却没生效，大概率是键名、参数或 URL 格式错了
这条命令不报错，但漏掉任意一个要素就等于白写：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
-
-g缺失 → 只影响当前目录，换个项目就失效 - 键名写成
repos.packagist、repo.packagist.org或packagist→ 静默忽略，fallback 到官方源 - type 值漏掉
composer→ Composer 不认识这是个镜像源，直接跳过 - URL 缺少末尾斜杠：
https://mirrors.aliyun.com/composer❌，必须是https://mirrors.aliyun.com/composer/✅ - 验证方式不是
composer config -g全量输出，而是精准查：composer config -g repo.packagist，应返回 JSON 对象，且url字段与你设置的一致
最容易被忽略的是：所有这些配置都依赖于 Composer 实际读取的配置文件位置。如果你用 sudo composer 执行过命令，它可能已经把配置写到了 /root/.composer/config.json，而你日常运行的是普通用户，读的是 $HOME/.composer/config.json。先运行 composer global config --list --verbose 看第一行 Loaded config file:，确认你在改的是它正在读的那个文件。
