本地包无法自动加载需检查autoload配置是否生效：须在包的composer.json中定义autoload/ autoload-dev，主项目用path仓库引入后运行composer update并执行dump-autoload验证映射。

本地包无法被自动加载？检查 autoload 配置是否生效

Composer 默认不会自动加载本地包的源码，除非你在根项目的 composer.json 中显式声明其自动加载规则。常见错误是只写了 "repositories" 却漏掉 "autoload" 或 "autoload-dev"，导致 vendor/autoload.php 根本不包含你的类。

实操建议：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 在本地包（即你正在开发的包）的 composer.json 中定义好 autoload，例如：

  "autoload": {
    "psr-4": {
      "MyVendor\MyPackage\": "src/"
    }
  }

• 在主项目中用 path 类型仓库引入后，必须运行 composer update myvendor/mypackage（不能只用 install），否则 Composer 不会重新生成 autoloader 映射
• 验证是否成功：执行 composer dump-autoload -o 后，检查 vendor/composer/autoload_psr4.php 里是否出现了你的命名空间映射

用 path 仓库时为什么总是拉取 dist 而非源码？

这是因为 Composer 默认启用 preferred-install 或受 packagist.org 元数据影响，即使你配置了 "type": "path"，它仍可能尝试从 dist 下载——尤其是当本地路径下没有 composer.json 或版本号与远程冲突时。

实操建议：

• 确保本地包根目录有合法的 composer.json，且 "version" 字段明确（如 "dev-main" 或 "1.0.x-dev"），避免 Composer 回退到远程解析
• 在主项目的 composer.json 中强制指定源码模式：

  "repositories": [
    {
      "type": "path",
      "url": "../mypackage",
      "options": {
        "symlink": true
      }
    }
  ]

• "symlink": true 是关键：它让 Composer 创建符号链接而非复制文件，修改本地包代码后无需反复 update，且能直接调试断点

composer update 后本地修改没生效？可能是缓存或 symlink 权限问题

即使配置了 path + symlink，仍可能出现“改了代码但 var_dump() 没变”的情况。这通常不是 Composer 逻辑问题，而是操作系统或 IDE 缓存干扰。

实操建议：

• 检查 symlink 是否真实创建：进入 vendor/myvendor/mypackage，执行 ls -la，确认它指向的是你的本地路径，而不是一个普通目录
• Windows 用户注意：默认 PowerShell/CMD 不允许创建符号链接，需以管理员身份运行终端，或在 Git Bash 中操作；也可临时改用 "symlink": false + composer update 强制同步（仅调试初期）
• IDE（如 PHPStorm）可能缓存了文件内容，右键点击 vendor 目录 → “Reload project from disk”，或关闭 “Use external file system” 选项
• 某些 CI 环境禁用 symlink，此时应改用 "options": {"copy": true} 并接受手动同步成本

想边写边测，但 phpunit 找不到测试类？

本地包的测试文件（如 tests/）默认不会被主项目的 autoloader 加载，因为 Composer 只处理 autoload 和 autoload-dev 块中声明的部分。如果你在本地包里写了测试，又想在主项目中运行，必须显式暴露。

实操建议：

• 在本地包的 composer.json 中补充：

  "autoload-dev": {
    "psr-4": {
      "MyVendor\MyPackage\Tests\": "tests/"
    }
  }

• 运行 composer update --no-interaction（避免交互式提示中断 autoload 更新）
• 若主项目使用 phpunit.xml，确保 <testsuites> 包含该路径，或直接运行：vendor/bin/phpunit --bootstrap vendor/autoload.php tests/
• 注意：不要在主项目的 autoload-dev 中重复映射本地包的测试命名空间，会造成冲突

本地包调试最易忽略的一点：Composer 的 autoload 机制是静态生成的，它不监听文件变化。哪怕你用了 symlink，只要没触发 dump-autoload（比如通过 update 或手动执行），新增的类就永远进不了 vendor/composer/autoload_*.php。