本地path仓库必须配置在项目根目录composer.json的repositories数组中，type为"path"，url用相对路径如"./packages/my-utils"；本地包自身composer.json需含合法name和version字段，require时版本须匹配如"dev-main"；windows需启用开发者模式或配置"options": {"symlink": true}才能生效符号链接。
本地path仓库必须配在项目composer.json的repositories里
ThinkPHP 项目本身不支持在全局或 vendor 内部配置 path 类型仓库，所有本地包引用都得显式写进项目根目录下的 composer.json 的 repositories 数组中。漏掉这一步，composer require 就会去 Packagist 盲搜，报 Could not find a matching version of package。
常见错误是把路径直接塞进 require 字段，比如："myorg/utils": "./packages/utils"——这语法非法，Composer 完全无视。
-
repositories中url推荐用相对路径（如"./packages/my-utils"），避免换机器后路径失效 - 绝对路径也行，但 Windows 下注意用正斜杠或双反斜杠，例如
"C:/dev/my-utils" - type 必须是
"path"，大小写敏感，写成"Path"或"PATH"都会静默失败
本地包自身composer.json必须有合法name和version
Composer 不认“目录存在”就等于“可安装”，它严格校验本地包的 composer.json：缺 name 或 version 字段，composer require 会直接跳过该仓库，不报错也不提示。
ThinkPHP 扩展包通常用 dev-main、dev-master 或 1.0.x-dev 这类开发版版本号，只要和你 require 时写的约束匹配就行（比如 "myorg/utils": "dev-main"）。
-
name格式必须是vendor/name，不能含空格或大写字母（"MyOrg/Utils"❌，应为"myorg/utils"✅） - 如果本地包还没定版，
version写"dev-main"最稳妥；若要用分支名，确保 Git 分支真实存在且可检出 - autoload 配置别漏，PSR-4 映射要指向正确源码目录，否则类自动加载会失败
Windows下symlink默认关闭，需手动启用或改用copy
Linux/macOS 默认对 path 仓库创建符号链接，改本地代码立刻生效；但 Windows 默认禁用 symlink，Composer 会 fallback 成文件复制，导致你改了本地包，项目里还是旧代码。
解决方法是在 repositories 配置里加 options 控制行为：
{
"type": "path",
"url": "./packages/my-utils",
"options": {
"symlink": true
}
}
- 启用 symlink 前，Windows 需管理员权限运行终端，或开启“开发者模式”（设置 → 更新与安全 → 针对开发人员）
- 不想折腾权限？把
"symlink": true改成"symlink": false，强制复制，适合 CI 或多用户共享环境 - CI 场景建议统一设
"symlink": false，避免因权限或系统差异导致构建失败
ThinkPHP服务提供者不会自动注册，必须手动检查config/app.php
即使 composer require 成功、本地包也软链进 vendor/，ThinkPHP 也不会自动发现并注册服务提供者。你大概率会遇到命令找不到、中间件不生效、类 Class 'xxx' not found。
根本原因是 ThinkPHP 6+ 依赖 config/app.php 中的 'providers' 数组显式声明服务类。
- 打开
config/app.php，确认'providers'数组里已添加你的本地包服务提供者，例如：MyOrg\Utils\ServiceProvider::class - 如果本地包没写 ServiceProvider，至少得补上 autoload 的 PSR-4 映射，并在需要的地方手动
app()->bind() - 别忘了检查
composer.json是否有"dont-discover": ["*"]—— 这个配置会关掉所有自动发现，包括你自己的包
最易被忽略的是：path 仓库配置完后没运行 composer update myorg/utils 或 composer require myorg/utils 触发重新解析，导致 Composer 缓存旧状态。改完 composer.json 后，务必执行一次 require 或 update。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
