Composer中文开发者专属：如何构建高复用性的Composer-Starter模板-composer-PHP中文网

post-create-project-cmd脚本不执行的根本原因是钩子未被composer识别：必须严格定义在模板项目根composer.json的"scripts"中，键名为全小写带连字符的"post-create-project-cmd"，且仅在create-project命令完成后于新项目根目录触发，install/update不会调用。

composer中文开发者专属：如何构建高复用性的composer-starter模板

能直接复用的 Composer Starter 模板，核心不在“模板有多漂亮”，而在“create-project 跑完后能不能立刻跑起来、不报错、不手动改一堆路径和命名空间”。

为什么 post-create-project-cmd 脚本总不执行？

很多人写了 post-create-project-cmd 却发现命令根本没跑——不是脚本写错了，是钩子没被识别。

composer.json 中必须把钩子放在 "scripts" 下，且 key 名严格为 "post-create-project-cmd"（大小写、连字符、拼写一个都不能错）
该钩子只在 composer create-project 命令执行完毕后触发，composer install 或 update 不会调用它
脚本内容如果是 PHP 文件，得确保它有可执行权限（chmod +x bin/init-project.php），且首行加 #!/usr/bin/env php
如果脚本里用了 __DIR__ 或相对路径，注意：它运行时的当前工作目录是新项目根目录，不是模板源目录

PSR-4 自动加载在新项目里失效？

create-project 拉下来的代码，autoload 配置还在，但 new AppSomething() 仍报 Class not found —— 问题出在“谁负责 dump-autoload”。

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": { "App\": "src/" } } 是对的，但新项目第一次运行前，vendor/autoload.php 还没生成
post-create-project-cmd 脚本里必须显式调用 composer dump-autoload，否则自动加载映射表为空
别依赖用户手动运行 composer install 来补这个动作——create-project 默认已执行 install，但不会重新 dump autoload
如果模板用了占位符替换（如把 App\ 替换成实际项目命名空间），替换后必须再 dump 一次，否则映射还是旧的

如何让模板支持不同项目名/作者名自动注入？

硬编码 "name": "acme/my-app" 和 "authors" 在模板里，会导致每个新项目都要手动改 composer.json —— 这违背“一键初始化”初衷。

用 composer create-project --stability=stable --no-interaction 后，Composer 会把命令行参数（如项目目录名）传给钩子脚本，但不传作者信息
更可靠的方式：在 post-create-project-cmd 脚本里读取当前目录名作为项目名，再用 file_get_contents('composer.json') + str_replace 或 json_decode/json_encode 动态重写 name 和 autoload 的命名空间前缀
作者信息建议留空或设为占位符 "authors": [{ "name": "Your Name", "email": "you@example.com" }]，并在 README.md 里加一行提示：“请首次提交前更新 author 信息”
千万别在模板里用 git init + git add . —— 这会让用户第一次 git status 看到一堆未跟踪文件，体验极差；留空 .git 目录，让用户自己决定是否初始化

发布到 Packagist 后，别人 install 总卡在 “Could not find package”？

本地测试成功 ≠ 发布后可用。Packagist 不是上传即生效，它需要正确解析你的包元数据。

确保模板项目的 composer.json 里 "name" 字段格式为 vendor/name（全小写、含斜杠），比如 "acme/laravel-starter"，不能是 "AcmeLaravelStarter" 或 "acme-laravel-starter"
Packagist 同步依赖 GitHub/GitLab webhook，推送 tag（如 v1.0.0）比 push main 分支更可靠；没打 tag，Packagist 可能只抓到 dev-main，而用户默认不装 dev 版本
用户执行 composer create-project acme/laravel-starter myapp 时，如果报错找不到包，先确认 composer show acme/laravel-starter 是否能查到 —— 查不到说明 Packagist 没收录，或名字拼错了
私有模板不要发到 Packagist，改用 repositories + type: "package" 手动注册，避免泄露内部结构

最易被忽略的一点：模板项目自身的 composer.lock 必须删除后再发布。它会把开发时的依赖版本锁死，导致新项目拉下来后 composer install 实际安装的是 lock 文件里那些版本，而不是模板 composer.json 声明的范围 —— 这会让新项目从第一天就偏离预期环境。