Composer install 不自动复制资产文件，因其仅管理PHP依赖而不介入文件分发；需通过scripts（如post-install-cmd）调用PHP脚本手动复制，或借助symfony/flex的assets:install机制（限Symfony/Laravel项目）。
为什么 composer install 不自动复制资产文件
Composer 本身只负责 PHP 包的依赖管理与自动加载，vendor/ 下的包资源（如 CSS、JS、字体等）默认不会被挪到 public/ 或 web/ 这类 Web 可访问目录。这是设计使然——它不假设你的项目结构，也不介入文件分发逻辑。
所以“安装后自动复制”不是 Composer 内置能力，必须靠扩展机制实现。
用 composer-scripts 触发自定义复制逻辑
最轻量、最可控的方式是利用 Composer 的 scripts 功能，在 post-install-cmd 或 post-update-cmd 阶段执行脚本。你不需要额外装插件，只要在 composer.json 里声明即可。
- 支持原生 PHP 脚本（推荐），也支持 shell 命令（跨平台性差）
- 脚本运行时工作目录是项目根目录，可安全读写
vendor/和public/ - 避免用
cp或xcopy，Windows/macOS/Linux 行为不一致；优先用 PHP 的copy()+RecursiveDirectoryIterator
示例：在 composer.json 中添加：
"scripts": {
"post-install-cmd": [
"php -r \"copy('vendor/acme/ui/assets/css/app.css', 'public/css/app.css');\""
],
"post-update-cmd": "@post-install-cmd"
}
更健壮的做法是把逻辑抽成独立 PHP 文件（如 scripts/copy-assets.php），再通过 "php scripts/copy-assets.php" 调用，便于调试和复用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
使用 symfony/flex 的 recipe 机制（Laravel/Symfony 项目适用）
如果你用的是 Symfony（≥4.0）或 Laravel（≥5.5），symfony/flex 插件已内置资产发布机制。它会在安装含 extra.symfony.assets 声明的包时，自动调用 assets:install 命令。
- 前提是项目已启用 Flex（检查
composer.json是否有"symfony/flex": "^2"） - 目标包需在自己的
composer.json中声明："extra": {"symfony": {"assets": "assets/"}} - 执行
composer install后，Flex 会自动运行php bin/console assets:install public --symlink
注意：该机制依赖 Symfony Console 和 Bundle 结构，纯 PHP 库或非 Symfony 项目无法直接复用。
常见坑：权限、路径硬编码与重复复制
实际部署中容易卡在这几个点：
-
public/目录不存在时，copy()会静默失败 —— 务必先mkdir -p public/css或用is_dir() + mkdir()判断 - 绝对路径写成
/var/www/myapp/public会导致本地开发失败 —— 全部用相对路径，基于__DIR__或getcwd() - 多次
composer install可能反复覆盖文件，但不会清理旧资产 —— 若包移除了某个 JS 文件，你的public/里还留着“幽灵文件” - 某些前端库（如
twbs/bootstrap）的资产在dist/下，而包的composer.json没声明extra，Flex 不会识别 —— 此时只能手动脚本处理
真正麻烦的不是复制动作本身，而是资产来源是否稳定、路径是否随包版本变更、以及是否要支持 symlink 或 hard copy。这些细节不提前想清楚，上线后才发现 CSS 404，就得翻日志逐条查。
