path仓库需在composer.json中用绝对路径配置repositories，require版本须与本地包version一致或为dev-main，且name严格匹配；上线前必须移除，仅限开发使用。

composer.json 里怎么写 path 类型仓库

本地开发时想边改包边用，不能每次改完都 push + packagist 同步，path 仓库是唯一靠谱的方案。它让 Composer 直接从你本机某个目录加载包，连 git 都不用初始化。

常见错误是只加了 repositories 却漏掉 require 的版本约束，或者路径写成相对路径（Composer 只认绝对路径或以 ./ 开头的相对路径，但推荐绝对路径防错）。

• 在项目根目录的 composer.json 里加 repositories 块，类型必须是 path，url 填本地包的绝对路径，比如 /Users/me/my-package
• require 里照常写包名和版本号，但这个版本号必须和你本地包的 composer.json 里 version 字段一致，或设为 "dev-main" / "dev-master"（取决于你本地分支名）
• 本地包的 composer.json 必须有 name 字段，且和 require 里的名字完全一致，大小写都不能错

运行 composer require 时为什么报 “could not find package”

不是网络问题，也不是包名打错——大概率是 repositories 没生效，或者版本不匹配。

Composer 默认只查 packagist.org，你加的 path 仓库不会自动覆盖全局源。它只对当前项目有效，而且只在 composer install 或 composer update 时读取；composer require 默认不触发仓库重载，所以会直接去线上找。

• 先手动删掉 vendor/ 和 composer.lock（如果已有）
• 确保 composer.json 已保存最新配置
• 运行 composer update vendor/package-name，而不是 require —— 这样才会强制走你配的 path 源
• 如果还是找不到，用 composer config --list | grep repositories 看仓库是否被正确读入

本地包改了代码，为什么 vendor 里没更新

因为 path 类型仓库默认启用 symlink（符号链接），不是拷贝。改本地代码，vendor 下对应目录的内容应该实时变化——但前提是你的系统和 Composer 版本支持 symlinks。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

Windows 上默认禁用 symlink（尤其老版本 Git Bash 或 CMD），macOS/Linux 一般没问题。另外，如果你之前用 composer install 装过非 path 版本，Composer 可能缓存了旧行为。

• 检查 composer.json 里 repositories 的 options 是否显式关掉了 symlinks（比如写了 "symlinks": false）
• 运行 composer update --no-cache vendor/package-name 强制刷新
• 确认 vendor/package-name 是个软链接：macOS/Linux 用 ls -l，Windows 用 dir 看有没有 标识

上线部署时 path 仓库还能用吗

不能。生产环境服务器上那个本地路径根本不存在，composer install 会直接失败。

很多人误以为只要把本地包一起传到服务器就行，但 Composer 不会自动识别“哦这是 path 包，我该从哪读”。它只认配置，而配置里写的还是你开发机的绝对路径。

• 上线前必须删掉 repositories 块，改用正规发布流程：打 tag、push 到私有 Git 服务器、配私有 Packagist 或 Satis
• 或者用 composer config --unset repositories 在 CI 脚本里临时清掉
• 更稳妥的做法：把 path 仓库定义放在 composer.json 的 config 里，用 COMPOSER_HOME 或环境变量控制是否启用，但实际很少这么搞，容易混淆

path 仓库只适合开发阶段快速验证，跨环境就失效。别想着“先本地跑通再上线”，得从一开始就想好包怎么发布。