静态站点不该用composer管理前端资源，因其不依赖php环境，vendor目录无意义；应由npm/yarn统一声明依赖，通过package.json的scripts触发构建，ci直调npm run build而非composer install。
静态站点不需要 Composer，它不是 PHP 运行环境，更不依赖 vendor/ 目录；所谓“用 Composer 管理静态站点前端资源”，本质是误用——你真正需要的是构建流程协调，而非包安装。
为什么静态站点不该装 Composer
静态站点生成器（如 Jekyll、Hugo、Hugo + Netlify CMS、Astro、Eleventy）本身不执行 PHP 代码，composer install 不会生成 HTML/CSS/JS，也不会触发任何构建逻辑。即使你硬塞一个 composer.json 进去，也只会增加部署失败风险：
-
composer install在无 PHP 环境的 CI（如 Vercel、Netlify）中直接报错：Command "composer" not found - 哪怕 CI 支持 PHP，
vendor/目录对最终输出无意义，既不参与渲染，也不被上传到 CDN - 把 Bootstrap 或 jQuery 用
npm-asset/bootstrap拉进vendor/，再手动复制到public/，纯属多绕三步路
该用 npm/yarn/pnpm 而不是 Composer 管理前端依赖
静态站点的 JS/CSS/图标/字体等资源，归属前端生态，应由 package.json 统一声明：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 所有库（
lodash、prismjs、tailwindcss）写在dependencies或devDependencies里 - 构建脚本（
"build": "tailwindcss -i ./src/css/input.css -o ./dist/css/output.css"）定义在scripts中 -
package-lock.json或yarn.lock必须提交，否则不同机器产出的 CSS 哈希值可能不一致 - 不要在
composer.json里写"npm-asset/tailwindcss": "^3.4"—— 这类包早已失效，且无法参与 PostCSS 插件链
如何让构建流程自动触发（而不是靠 Composer）
静态站点的构建入口必须是前端命令，CI 配置要直指 npm run build，而非 composer install：
- Netlify：在
netlify.toml中设command = "npm run build"，别写"composer install && npm run build" - Vercel：默认识别
package.json的build字段，无需额外配置；加composer反而触发 PHP 构建阶段，浪费时间 - GitHub Pages + Actions：workflow 文件里用
uses: actions/setup-node@v4，然后run: npm ci && npm run build - 若真要用 PHP 工具（比如 Twig 模板预编译），应单独封装为 CLI 工具，通过
npx或php bin/build.php调用，不依赖composer install触发
唯一可能用到 Composer 的例外场景
仅当你的“静态站点”实际是 PHP 渲染后导出的产物（例如用 Laravel + Blade 模板 + spatie/laravel-export 生成纯 HTML），且导出过程需调用 PHP 类库时，Composer 才有意义：
- 这种情况下，
composer install是为了运行 PHP 导出脚本，不是为了管理前端资源 - 前端仍走
package.json，构建产物（dist/）由 PHP 脚本读取并嵌入 HTML，而非从vendor/复制 - 切勿在
post-install-cmd里写npm run build—— 因为composer install可能在无 Node.js 的服务器上执行，导致中断
真正容易被忽略的点：很多人以为“统一用 Composer 就能简化流程”，结果反而把构建卡在 PHP 环境检查、插件兼容性、路径拼接错误上。静态站点的干净和可靠，恰恰来自职责分离——Node.js 管前端，PHP（如果存在）管后端逻辑，构建命令就是唯一真相。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
