用path类型仓库可让主项目实时加载本地包代码，改完即生效；需在主项目composer.json中配置repositories为相对路径、require版本匹配dev分支、启用symlink并确保autoload严格正确。

能立刻在主项目里用上你刚写的代码，不用发版、不等同步、改完即生效——靠 path 仓库类型，不是靠反复 composer update 或清缓存。

本地开发时怎么让主项目直接加载你的包代码

别等打 tag、提交 Packagist、再 composer require，那是在模拟生产，不是开发。开发阶段必须用 path 类型仓库，让 vendor/ 下的包目录变成指向你本地源码的符号链接。

• url 必须是相对路径（如 "../my-package"），不能含空格或 ~；跨出项目根目录的 ../ 是允许的，但 ../../ 容易因工作目录不同失效
• 主项目 composer.json 的 repositories 里只加一条，别混用 packagist 和 path，否则缓存可能错乱导致找不到包
• 执行 composer require vendor/name:dev-main（分支名要和你本地仓库默认分支一致），不是 install；update 才会重建软链接
• 验证是否成功：运行 readlink vendor/vendor/name，输出应为你的本地路径；如果为空，说明没走 path 模式，大概率是本地包的 composer.json 缺 name 或 type 不是 "library"

为什么类总报 Class not found，autoload 配置怎么才算对

PSR-4 不是“差不多就行”，是严格字符串匹配：命名空间末尾双反斜杠、路径末尾斜杠、文件名大小写、目录层级，四者缺一不可。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 假设 autoload.psr-4 写的是 {"MyOrg\MyPackage\": "src/"}，那 src/ 下必须有 MyOrg/MyPackage/Helper.php，且里面 namespace MyOrg\MyPackage; ——少一个 \ 或多一层 src/MyOrg/MyPackage/src/ 都会失败
• Linux/macOS 下大小写敏感，Helper.php 不能叫 helper.php；Windows 可能暂时不报错，但部署到服务器必挂
• 改完 composer.json 后，必须手动运行 composer dump-autoload -o，否则新映射不生效；-o 生成优化加载器，避免开发期反复解析
• 别把 tests/ 或 bin/ 塞进 autoload.psr-4，该进 autoload-dev；否则上线项目会无故加载测试类，影响性能

发布到 Packagist 前必须检查的四个硬字段

Packagist 不校验代码，只扫 composer.json 四个字段：错一个，就根本不会出现在搜索结果里，连 “Package not found in VCS” 都不给你报。

• name 必须是小写 vendor/name 格式（如 myorg/http-client），vendor 必须和你在 Packagist 注册的用户名完全一致；MyOrg/HttpClient、my_org/http_client 全部非法
• type 显式写 "library"；留空、写 "project" 或 "metapackage"，Packagist 直接跳过
• autoload.psr-4 键值都要带结尾符号："MyOrg\HttpClient\": "src/" —— 注意命名空间末尾双反斜杠、路径末尾斜杠，一个都不能少
• license 字段不可省略，填 "MIT" 最稳妥；写成 "mit" 或 "MIT license" 会被拒收

Git tag 不是可选项，是版本存在的唯一依据

composer.json 里的 "version": "1.0.0" 字段会被 Packagist 完全忽略。它只认 Git tag，且只认两种格式：v1.0.0 或 1.0.0。

• 打 tag 必须用 git tag -a v1.0.0 -m "Release"（带 -a 生成 annotated tag），轻量 tag（git tag v1.0.0）Packagist 可能无法解析
• 打完必须推送到远程：git push origin v1.0.0 或 git push --tags；只 git push 主分支，Packagist 看不到新版本
• 改了 composer.json 又想重发同版本？先删远程 tag：git push origin :v1.0.0，再删本地：git tag -d v1.0.0，最后重新打+推
• 首次提交到 Packagist 后，后续新 tag 不会自动出现，必须去包页面点 “Update” 手动刷新，或提前配好 GitHub webhook

最常被忽略的其实是命名空间与路径的严丝合缝：一个反斜杠位置不对、一个目录名大小写偏差、一个 tag 没推送，都会让别人 composer require 失败，而错误信息里往往只显示 “Class not found” 或 “Package not found”，根本看不出卡在哪一步。