本地修改依赖后主项目不生效，根本原因是Composer默认只从Packagist拉取远程包，必须在主项目composer.json的repositories中显式配置type: "path"并指定相对路径，且require中使用"@dev"标识，同时确保本地包有合法name字段、删除vendor和composer.lock后重新install。

本地修改依赖后，主项目不生效？不是 composer update 没用，而是你没告诉 Composer：这个包，别去 Packagist 下，就用我硬盘上的那份。

为什么 composer require 无法加载本地路径包

因为 composer require vendor/name 默认只从 Packagist 拉取远程包，它完全无视你本地文件夹里有没有同名代码。即使你把库 clone 到项目旁边，Composer 也当它不存在——除非你显式声明“这里有个替代源”。

• composer require 只改 composer.json 的 require 字段，并触发远程安装逻辑
• 要让本地目录参与依赖解析，必须在 repositories 里加一条 type: "path" 记录
• 该记录的 url 必须是相对于 composer.json 的相对路径（如 ../my-sdk），不能是绝对路径或 file:// 协议
• 如果本地包没有 composer.json（比如只是个纯脚本目录），Composer 会直接报错退出，不给你任何提示

type: "path" 配置写在哪、怎么写才有效

必须写在项目根目录的 composer.json 顶层 repositories 数组里，且位置要在 require 之前（顺序无关，但放前面更易维护）。它的作用不是“添加依赖”，而是“重定向依赖来源”。

• 示例配置：

  {
    "repositories": [
      {
        "type": "path",
        "url": "../php-management-api-client"
      }
    ],
    "require": {
      "storyblok/php-management-api-client": "@dev"
    }
  }

• "@dev" 是关键：它告诉 Composer 这个包允许使用开发版（即本地未打 tag 的代码），否则即使配置了 path，Composer 仍可能跳过本地目录去匹配稳定版本
• 多个本地包？直接往 repositories 数组里追加对象，每个对应一个 url
• 配置完别忘了删掉 vendor/ 和 composer.lock，再跑一次 composer install，否则旧锁文件会继续指向远程包

本地包改动后，主项目为何还是旧行为

常见原因不是缓存，而是自动加载没刷新，或者你改错了文件位置。Composer 的 path 模式不会复制文件，它直接 symlink（Linux/macOS）或 junction（Windows）到 vendor/，所以源文件一改，立刻可见——前提是路径对、符号链接建成功了。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记（深入）”；

• 检查 vendor/storyblok/php-management-api-client 是否是个软链接（ls -la 看目标路径是否指向你本地目录）
• 如果看到的是普通文件夹，说明上次 install 失败了，大概率是本地包的 composer.json 缺少 name 或 version 字段
• 改完本地代码后，不需要 composer dump-autoload —— symlink 已存在，类文件路径没变；但如果加了新类且用了 PSR-4，就得运行 composer dump-autoload
• PHP OPcache 可能缓存了旧字节码，开发时建议关掉：opcache.enable=0（php.ini）或临时加 opcache_invalidate()

调试时误删 vendor/ 导致 composer install 失败怎么办

最常卡在 “Your requirements could not be resolved”，本质是 Composer 在重建依赖图时，发现本地 path 包的 composer.json 里写了不兼容的 PHP 版本或扩展要求（比如 "ext-gmp": "*"），而当前环境不满足。

• 先确认本地包的 composer.json 中 require 字段是否引入了你环境里没有的扩展，比如 "ext-redis": "*" 但没装 redis 扩展
• 临时绕过检查：运行 composer install --ignore-platform-reqs（仅限调试，别提交）
• 更稳妥的做法：在本地包的 composer.json 里把平台要求写宽松些，例如 "php": ">=7.4" 而不是 "php": "^8.2"
• 如果连 composer install 都报错说找不到 repositories 里的路径，说明 url 写错了——用 pwd 和 ls -la ../your-package 对比路径是否真实存在

真正容易被忽略的点：本地 path 包的 composer.json 必须有合法的 name（格式为 vendor/name），且和主项目 require 里写的完全一致，一个字母都不能差；大小写敏感，连中划线和下划线都算不同名字。