wordpress主题中不可直接require vendor/autoload.php，否则会导致类重复声明或找不到；应通过classmap方式加载单个库或在after_setup_theme钩子中安全引入。
WordPress主题里直接require Composer自动加载会出问题
因为WordPress默认不执行vendor/autoload.php，主题里直接require 'vendor/autoload.php'看似能用，但会污染全局加载器——一旦两个插件/主题各自require自己的autoload.php，PHP会报Cannot redeclare class或Class not found。这不是你代码写错了，是PSR-4自动加载器被重复注册导致的。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 永远不要在
functions.php或模板文件里require 'vendor/autoload.php' - 改用
composer install --no-autoloader生成不含全局注册逻辑的autoload.php（需配合自定义加载） - 更稳妥的做法：把
vendor目录里的类全部重命名空间隔离，或只加载你需要的单个库（见下一条）
用classmap方式加载单一现代PHP库（如league/flysystem）
如果你只需要一个库（比如处理云存储），又不想碰全局autoload，classmap是最轻量、最可控的方式。它不依赖命名空间自动发现，而是把所有类路径硬编码进autoload_classmap.php，加载时只查表，不扫描目录，也不会和别的autoload.php冲突。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在主题根目录运行：
composer require league/flysystem:^3.0 --no-scripts - 编辑
composer.json，添加："autoload": { "classmap": ["vendor/league/flysystem/src/"] } - 运行
composer dump-autoload，生成vendor/composer/autoload_classmap.php - 在主题
functions.php中只require_once get_template_directory() . '/vendor/autoload.php';——这个autoload.php此时只负责载入classmap，不注册spl_autoload_register
psr-4映射到主题子目录时，命名空间必须与目录结构严格一致
想把src/MyTheme/Utils/Http.php映射为MyThemeUtilsHttp，不是靠文件名猜，而是靠composer.json里写的路径是否真实存在、大小写是否完全匹配。Windows开发机上不敏感，部署到Linux服务器就Class not found——因为src/mytheme/Utils/Http.php和MyThemeUtilsHttp根本对不上。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
composer.json中psr-4配置示例："autoload": { "psr-4": { "MyTheme\": "src/" } } -
src/必须是主题根目录下的真实子目录，不能是inc/或lib/（除非你改映射） - 类文件路径必须全小写对应命名空间层级，
MyThemeUtilsHttp→src/Utils/Http.php，中间不能有utils/或HTTP.php - 运行
composer dump-autoload -o后检查vendor/composer/autoload_psr4.php内容，确认键值对正确
主题启用时才加载Composer类，避免后台/CLI环境失败
WordPress在wp-cron、WP-CLI、REST API请求中可能不加载主题的functions.php，但如果你在after_setup_theme钩子之外就require autoload.php，这些场景下会直接PHP Fatal error: Class 'X' not found。不是类没装好，是加载时机错了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 把
require_once放到after_setup_theme或template_redirect钩子里（前者更早，后者确保前端上下文） - 如果库要用于REST路由，额外加一层判断：
if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) { require_once ... } - 永远用
get_template_directory()而非__DIR__拼接vendor/autoload.php，否则子主题继承时路径失效
spl_autoload_register。 
