本地包需在项目composer.json的repositories中配置path类型及相对路径，require中声明包名；启用symlink须设preferred-install为source并初始化Git；autoload映射错误或未执行dump-autoload会导致类找不到。
本地包怎么配进项目 composer.json？
直接在项目根目录的 composer.json 里加 repositories 段，类型设为 path，url 填相对路径（比如 "../my-utils"），再在 require 里写对应包名（如 "vendor/my-utils": "*"）。url 不能用绝对路径，Windows 下也别写 C: 开头；本地包自己的 composer.json 必须有合法 name 和 version（哪怕写 "dev-main"），否则 Composer 匹配失败。
为什么 composer install 后没生成软链接？
默认行为是硬拷贝——整个本地包被复制进 vendor/，改源码不会实时生效。要启用 symlink，必须两步到位：
• 运行 composer config --local preferred-install '{"*": "source"}'
• 在本地包根目录初始化 Git：git init && git add . && git commit -m "init"
Windows 用户还得确认开了开发者模式或以管理员身份运行终端，否则系统拒绝创建符号链接。
composer require 能不能跳过 repositories 直接写路径？
不能。require 字段只认包名，不接受文件路径。你写 composer require ../my-local-package 会报错 Could not parse version constraint。必须先配好 repositories，再执行 composer require vendor/name，让 Composer 自动关联到你声明的 path 仓库。
装完类找不到，是不是 autoload 没配对？
很可能是。本地包的 composer.json 里 autoload 配置必须正确，比如 PSR-4 映射要覆盖实际源码路径："autoload": {"psr-4": {"MyVendor\": "src/"}}。改完本地包的 autoload 后，别忘了在项目根目录运行 composer dump-autoload 刷新自动加载映射——否则即使路径对了，new MyVendorSomeClass() 仍会报 Class not found。
立即学习“PHP免费学习笔记（深入）”；
路径、Git 初始化、autoload 刷新这三处最容易漏掉，缺一不可。
