path仓库比dev-main symlink更可靠，因其强制启用符号链接、跳过版本校验、直接映射本地路径，autoload规则正常生效且无需手动dump-autoload。

本地开发的 Composer 包，不用反复 composer install 或推 tag，直接用 path 仓库就能实时加载修改后的代码。

为什么 path 仓库比 dev-main symlink 更可靠

很多人试过在 require 里写 "my/package": "dev-main" 再配 repositories 的 package 类型，结果发现自动加载不生效、类找不到，或者改了源码要清缓存重装。根本原因是 Composer 默认对 package 类型仓库不做自动符号链接（symlink），而 path 类型会强制启用 symlink（只要文件系统支持），且跳过版本约束校验，直接映射到本地路径。

• path 类型下，Composer 把你的本地目录当“已安装包”看待，autoload 规则照常走，vendor/autoload.php 能正常加载
• 不需要手动 composer dump-autoload，改完源码立刻生效（除非用了 OPCache，需重启 PHP 进程）
• 不依赖 Git 分支或 tag，连 .git 目录都不需要存在

正确配置 path 仓库的三步操作

假设你在 /home/user/my-package 开发一个包，主项目在 /home/user/my-app，目标是让 my-app 加载修改中的 my-package。

Academic Composer Upload

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

下载

• 在 my-app/composer.json 的 repositories 里加一条：

  "repositories": [
    {
      "type": "path",
      "url": "../my-package"
    }
  ]

  注意：url 是相对于 composer.json 文件的路径，不是相对于命令行当前目录
• 把包名和版本写进 require，版本必须是 "*@dev"（不能是 "dev-main" 或 "dev-master"）：

  "require": {
    "my/package": "@dev"
  }

• 执行 composer update my/package（不要用 install，否则可能跳过 path 解析）

常见报错和绕过方法

运行 composer update 时提示 Could not find package my/package at version *@dev，基本是以下原因：

• my-package/composer.json 缺少 "name" 字段，或值与 require 中不一致（大小写敏感）
• url 路径错误，Composer 找不到该目录（可用 ls -l ../my-package 验证）
• 路径中含空格或中文——Linux/macOS 下部分 shell 会截断，建议用相对路径且避免特殊字符
• Windows 上用反斜杠 \ ——一律改用正斜杠 /，Composer 内部统一处理
• 如果包里有 autoload-dev，但主项目没启用它，类不会被加载；确认 composer dump-autoload --dev 是否执行过

调试 path 是否生效的两个命令

别只看 vendor/ 有没有生成软链，关键看 Composer 内部怎么解析的：

• composer show my/package 输出里若出现 source: path /home/user/my-package，说明 path 生效
• composer config repositories 可确认 repositories 配置是否被读取（有时因 JSON 格式错误被静默忽略）
• 顺手删掉 vendor/my/package 和 composer.lock，再 composer update，能排除缓存干扰

最易被忽略的是：改了 my-package 的 composer.json（比如加了新 autoload 规则），必须重新运行 composer update my/package，否则主项目的自动加载器不会更新映射关系。