composer init生成的composer.json缺关键配置：type错误、autoload路径不匹配、extra框架扩展缺失、require漏框架依赖；本地包需repositories path配置、name一致、dev分支版本、启用symlink并update生效。
composer init 生成的 composer.json 为什么不能直接用
它只填了基础字段，缺了扩展包能被框架识别和自动加载的关键配置。Laravel、Yii 或 ThinkPHP 都不靠 name 和 description 去注册服务或加载类，而是依赖 type、autoload、extra 这些字段。
常见缺失项：
-
type字段没写或写错（比如该写"laravel-package"却写了"library"） -
autoload.ps r-4的命名空间路径不匹配实际目录结构（如声明"Acme\Demo\": "src/"，但类文件放在src/Support/下且没嵌套子命名空间） - 没加
extra.laravel.providers或extra.yii2，导致框架启动时不扫描你的ServiceProvider -
require里漏了框架本身（如 Laravel 包没写"illuminate/support": "^10.0"），后续在项目中 install 会报依赖冲突
本地开发时 require 本地包却提示 “Could not find package”
根本不是网络或权限问题，是 Composer 根本没“看到”你那个目录。它只查主项目的 repositories 数组，不递归扫描文件系统。
必须同时满足这三点：
- 主项目
composer.json的repositories里有 type:"path"条目，url是相对路径（如"./packages/my-pkg"），不能是绝对路径（"C:/work/my-pkg"在 Windows 下常静默失败） - 本地包目录下存在合法
composer.json，其中name字段与你在主项目中composer require的完全一致（包括大小写） - 本地包的
composer.json中版本必须用分支名（如"dev-main"或"dev-develop"），不能写"1.0.0"—— path 类型不走 tag 解析逻辑
改完本地包代码，主项目里不生效
默认行为是复制（copy），不是链接（symlink）。改源码后，vendor 目录里的文件还是旧的。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
要启用实时同步，得在主项目的 repositories 条目里显式加 "options": {"symlink": true}：
{
"type": "path",
"url": "./packages/my-pkg",
"options": {
"symlink": true
}
}
然后执行 composer update vendor/name（不是 install，也不是 dump-autoload）。验证方式：
- Linux/macOS：运行
ls -la vendor/vendor/name，输出里应有->指向源目录 - Windows：运行
dir vendor\vendor\name，应显示为“快捷方式”类型 - 如果看到的是普通文件夹且内容与源目录不一致，说明 symlink 没生效，大概率是没加
options或权限不足
发布前最容易被忽略的兼容性陷阱
不是所有环境都支持 symlink，尤其是 CI/CD 流水线或 Windows 默认终端。你以为本地跑通就万事大吉，上线部署时可能直接 fail。
稳妥做法是提前约定两种模式：
- 开发态：用
"symlink": true+@dev版本约束，确保热更新 - 构建态：在 CI 脚本里加
"preferred-install": {"vendor/name": "dist"}，强制走 copy 模式 - 别依赖
composer link：Laravel 10+ 和 Windows 上 autoload 冲突频发，path+symlink是目前最可控的组合
还有个隐形坑：本地包没做 git init 且没任何 commit，Composer 会跳过整个目录——它把 path 源当成一个“Git 工作区”来对待，哪怕你根本不用 Git。
