Composer全局命令失效主因是bin-dir未正确加入PATH，需用--absolute获取绝对路径并配置；本地包autoload需主项目显式声明且dump-autoload；path仓库require失败多因name/url不匹配或路径格式错误；CI环境须移除path仓库并使用真实源。

composer global require 的命令找不到，先查 bin-dir 路径

根本不是包没装上，而是系统压根没找到可执行文件。运行 composer config --global bin-dir --absolute，它会输出真实路径，比如 /home/alice/.composer/vendor/bin 或 C:UsersAliceAppDataRoamingComposerendorin。这个路径必须加进 PATH，且不能漏掉末尾斜杠、不能含中文或空格、不能加成相对路径。

常见错误：

• composer config --global bin-dir 不加 --absolute 会返回 vendor/bin 这种相对路径，直接粘贴进 PATH 必然失效
• Windows 用户误把 %APPDATA%Composerendorin 加进「系统变量」而非「用户变量」，导致新终端读不到
• macOS/Linux 写进 ~/.bashrc 却用的是 zsh，默认不加载，应改 ~/.zshrc
• Git Bash 完全不读 Windows 系统 PATH，必须单独编辑 ~/.bashrc 并写 export PATH="$APPDATA/Composer/vendor/bin:$PATH"

全局命令能运行但报错“Class not found”，检查 autoload 是否覆盖本地路径

你用 path 类型仓库引入了本地包，composer install 成功了，但 new LocalPackageSomeClass() 仍报错——大概率是 autoload 没映射到真实路径。Composer 不会自动继承本地包的 autoload 配置，主项目必须显式声明或手动刷新。

实操建议：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 确认本地包的 composer.json 里有合法 autoload 段（如 "psr-4": {"LocalPackage\": "src/"}），且 src/ 下文件 namespace 前缀完全匹配
• 主项目改完 repositories 后，必须运行 composer dump-autoload -o，否则旧映射还在 vendor/composer/autoload_psr4.php 里
• 打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，看映射路径是否指向本地包的真实绝对路径（比如 /home/alice/my-pkg/src/）
• 如果映射路径仍是 vendor 下的复制副本（如 /home/alice/project/vendor/localpackage/somepackage/src/），说明 symlink 失败 fallback 成 copy，需检查本地包是否声明了 "options": {"symlink": true}

path 仓库 require 失败却无报错，重点核对 name 和 url 格式

现象是 composer require localpackage/utils 执行后没报错，但 vendor/localpackage/utils 目录不存在，composer show --all 也看不到该包——这不是网络或权限问题，是 name 或 url 根本没被识别。

关键约束：

• name 字段在本地包 composer.json 中必须和 require 语句里写的**逐字一致**：大小写、短横线 -、vendor 名全部对齐，acme/utils ≠ Acme/utils ≠ acme_utils
• url 必须指向**含 composer.json 的目录**，不能是文件，也不能以 / 结尾（"url": "../my-pkg/" 会被静默忽略）
• 路径是相对于主项目 composer.json 的位置，不是 shell 当前目录；Windows 上路径含中文或空格会导致解析失败
• Linux/macOS 下若 ls -la vendor/localpackage/utils 显示为普通目录而非符号链接，说明 symlink 创建失败，要检查本地包是否声明 "options": {"symlink": true} 及当前终端权限

CI/CD 中 path 仓库行为异常，必须剥离配置再上线

本地一切正常，但 CI 流水线跑 composer install 报 Could not find package 或加载类失败——因为 path 仓库只适用于开发阶段，CI 环境没有本地目录，也不该依赖符号链接。

标准做法：

• CI 构建前，用 composer config --unset repositories.my-local-repo 移除所有 path 类型仓库
• 确保 composer.json 中 require 的版本号已锁定（如 "localpackage/utils": "^1.0"），并发布到 Packagist 或私有源
• 流水线中不要运行 composer dump-autoload -o 后再 commit，这会让 autoload_classmap.php 写入本地路径，导致部署时路径失效
• 若必须调试，可在 CI 中临时启用 COMPOSER_HOME 指向缓存目录，并用 --no-plugins 避免某些插件干扰，但上线前必须还原

真正容易被忽略的是：path 仓库的 autoload 不会自动合并进主项目，哪怕你本地改了 src/ 下的类，不手动 dump-autoload，就不会生效；而 CI 环境里连 dump-autoload 都不该运行——它只属于开发机。