Composer 不加载静态文件（CSS/JS/图片等），因其 autoload 仅处理 PHP 类文件，psr-4、classmap、files 均跳过非 PHP 后缀，误配会拖慢构建、污染 classmap、引发运行时错误。
Composer 不会加载静态文件（CSS/JS/图片等），autoload 配置里写任何静态路径都无效——它只处理 PHP 类文件，强行塞进去只会拖慢 composer dump-autoload，还可能污染 classmap。
为什么 autoload 配置 public/css 之类路径完全没用
Composer 的 psr-4、classmap、files 三类 autoload 规则，底层只识别 PHP 可执行后缀（.php、.inc、.hh）。遇到 .css、.js、.svg 等文件，直接跳过，不解析、不映射、不生成路径条目。
-
"psr-4": {"Assets\": "public/css/"}→ Composer 扫描public/css/下所有.php文件（通常一个都没有），映射表为空，毫无作用 -
"classmap": ["public/css/"]→ 会递归扫描该目录下所有.php文件（仍可能为零），但同时把.js、.map等无关文件路径也塞进autoload_classmap.php，导致文件体积暴涨、OPcache 缓存效率下降 -
"files": ["public/js/app.js"]→ 这个语法合法，但app.js不是 PHP 文件，运行时require_once直接报错：Fatal error: Uncaught Error: Failed opening required ...
静态资源被误塞进 autoload 的典型错误配置
这些写法看似“想让资源可访问”，实则破坏构建流程和部署效率：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
"psr-4": {"": "vendor/twbs/bootstrap/dist/"}—— 空命名空间前缀触发全目录扫描，数千个非 PHP 文件被遍历，composer install -o卡死数分钟 -
"classmap": ["vendor/almasaeed2010/adminlte/"]—— 把整个 AdminLTE 包（>20MB）扫进 classmap，生成的autoload_classmap.php超过 8MB，OPcache 缓存失效频繁 -
"autoload-dev": {"files": ["vendor/ckeditor/ckeditor.js"]}——files在每次 Composer 启动时无条件require_once，但 JS 文件无法执行，直接中断加载流程
正确让静态资源可用的三种做法
核心原则：静态资源不走 autoload，只走 Web 服务器路径或构建工具链。
- 前端资源统一交给
npm或yarn管理，安装到resources/assets/，再由Vite或Webpack构建输出到public/build/，PHP 项目通过<link href="/build/app.css">引用 - 遗留项目必须用 Composer 装前端包（如 Yii1），则用
fxp/composer-asset-plugin，它会把npm-asset/bootstrap解压到独立目录（如web/assets/bootstrap/），且自动过滤非 PHP 文件，不参与 autoload 扫描 - 若只是少量自定义 CSS/JS，手动复制到
public/css/或public/js/，由 Web 服务器（Nginx/Apache）直接服务，PHP 层完全不感知其存在
如何验证某个路径是否真被 autoload 扫描了
别靠猜，查生成文件最准。先确保已执行 composer dump-autoload -o：
- 打开
vendor/composer/autoload_classmap.php，搜索你写的路径关键词（如public/css）——如果出现，说明被 classmap 扫了，要删掉相关配置 - 打开
vendor/composer/autoload_psr4.php，检查是否有你声明的命名空间（注意末尾反斜杠："Assets\"✅，"Assets"❌） - 运行
composer show --path vendor/twbs/bootstrap看包实际位置，再确认你的 Web 服务器能否从该路径（如/var/www/html/vendor/twbs/bootstrap/dist/css/）直接访问文件
真正容易被忽略的是：即使你删掉了 autoload 配置，旧的 autoload_classmap.php 仍可能残留无效路径——务必执行 composer dump-autoload 清空并重建，否则问题照旧。
