Composer无法直接require未发布本地包，需在项目composer.json的repositories中配置path类型仓库，指定相对路径及合法composer.json，再执行composer require vendor/name:dev-main实现“伪装远程包”效果。
本地包怎么让 composer require 当成远程包用
直接在项目里 composer require 一个还没发布到 Packagist 的本地扩展包，是行不通的——Composer 默认只认远程仓库。但开发阶段又必须提前验证依赖关系、自动加载、服务提供者注册等行为是否正常。核心解法是把本地目录“伪装”成一个可被 Composer 解析的仓库类型。
最稳妥的方式是使用 path 类型仓库：在项目根目录的 composer.json 中添加：
{
"repositories": [
{
"type": "path",
"url": "../my-awesome-package"
}
]
}
然后执行：composer require my-vendor/my-awesome-package:dev-main（注意版本必须匹配本地包 composer.json 中的 "version" 或分支名，如 dev-main、dev-develop）。
关键点：
-
url必须是相对路径，且指向含有效composer.json的目录（不能是空文件夹或没声明name字段） - 本地包的
composer.json里必须有明确的"name"（格式为vendor/name），否则 Composer 会报Package name is invalid - 该方式下修改本地包代码无需重新
composer update，因为path是符号链接式挂载，改完即生效
为什么 vendor 目录里看到的是 symlink 而不是复制文件
这是 path 仓库的默认行为，也是你想要的：它在 vendor/my-vendor/my-awesome-package 下创建一个指向 ../my-awesome-package 的软链接，而非拷贝一份。好处是实时调试、避免重复构建。
但要注意两个常见坑：
- Windows 上若未启用开发者模式或管理员权限，
mklink可能失败，导致composer install报错Could not create symlink；此时加--no-plugins或换用artifact方式（见下条） - 某些 IDE（如 PHPStorm）默认不跟随 symlink，需手动开启 “Follow symbolic links” 选项，否则跳转类定义会失败
不想用 symlink？试试 artifact 仓库
如果目标环境禁止 symlink（比如某些 CI/CD 或容器），可用 artifact 类型：把本地包打包成 .zip，再告诉 Composer 去这个 zip 文件里找包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
步骤：
- 在本地包根目录运行：
composer archive --format=zip --file=my-awesome-package.zip - 在项目
composer.json的repositories中写：
{
"type": "artifact",
"url": "./packages/"
}
并把 my-awesome-package.zip 放进 ./packages/ 目录。
优势：
- 完全规避 symlink 权限问题
- zip 包内含完整
composer.json和源码，和真实 Packagist 行为一致 - 适合做预发布验证，比如发给 QA 团队试用
代价是每次改代码都要重打 zip、重跑 composer update，不如 path 高效。
测试 autoload 和 service provider 时最容易漏哪步
即使 composer require 成功，Laravel 或其他框架也未必能立刻识别你的本地包——因为自动加载映射和配置注册是两件事。
必须确认三点：
- 本地包的
composer.json有正确"autoload"（如"psr-4": {"MyVendor\MyPackage\": "src/"}），否则composer dump-autoload不会扫描进去 - 若包含 Laravel Service Provider，需手动在
config/app.php的providers数组里加一行（Laravel 10+ 的自动发现对path仓库支持不稳定，别依赖） - 改完 autoload 后，一定要运行
composer dump-autoload -o（加-o生成优化版映射），否则新命名空间可能不生效
最后提醒一句：别在本地开发时把 path 仓库配置提交到 Git。它只对你本机有效，别人拉代码会直接报 Repository not found。上线前务必删掉 repositories 块，改用 Packagist 正式发布后的地址。
