October CMS 的 composer.json 在插件或主题子目录下（如 plugins/acme/blog/composer.json），而非根目录；根目录的仅用于核心框架，插件/主题依赖必须声明在各自目录的 composer.json 中并设 type 为 october-plugin 或 october-theme。
October CMS 的 composer.json 放哪？为什么不能直接改根目录那个
October CMS（尤其是 v2+）本身是基于 Laravel 构建的，但它的插件和主题**不通过根目录的 composer.json 管理依赖**——那是给 CMS 核心框架用的。你手动往里面加插件包，Composer 会装上，但 October 完全感知不到，插件不会注册、路由不加载、后台不显示。
真正起作用的是每个插件/主题自己目录下的 composer.json。比如插件 acme/blog，路径是 plugins/acme/blog/composer.json；主题 rainlab/vanilla 则在 themes/rainlab/vanilla/composer.json。
- 插件/主题的
composer.json必须包含"type": "october-plugin"或"type": "october-theme" - 必须声明
"name"（格式为vendor/name），且与目录路径严格一致（acme/blog→plugins/acme/blog/） - 依赖写在
"require"里，例如"php": "^8.1", "october/rain": "~2.0"，不是为了装包，而是让 October 启动时校验兼容性
装第三方包（比如 Guzzle）进插件，该在哪个 composer.json 里写？
如果你的插件代码里要调用 GuzzleHttp\Client，这个依赖必须写在插件自己的 composer.json 里，而不是项目根目录的。否则运行时会报 Class 'GuzzleHttp\Client' not found —— 因为 October 加载插件时，只读取插件目录下的 autoload 配置。
操作很简单：进入插件目录，运行 composer require guzzlehttp/guzzle。它会自动更新插件内的 composer.json 和 vendor/，并生成对应的 autoload 规则。
- 别用
composer install在插件目录下跑（除非你删了vendor/且有composer.lock）——直接require更安全 - 如果插件已启用，改完依赖后需执行
php artisan october:up，否则 October 不会重扫 autoload - 避免在插件里
require与核心冲突的包（如不同版本的symfony/console），October v2 对 PSR-4 自动加载较敏感
php artisan plugin:install 和 composer require 什么区别？
php artisan plugin:install rainlab.blog 是 October 自己的命令，它干三件事：从 Packagist 下载包、解压到 plugins/rainlab/blog、执行插件的 Plugin.php 中的 register() 和 boot()。但它**不运行 Composer 的 autoload 生成逻辑**。
而 composer require rainlab/blog 是标准 Composer 行为：写入根 composer.json、装包、更新 autoload。但 October 不认这个路径（它默认装进 vendor/rainlab/blog），插件不会出现在后台列表里。
- 想快速试用官方插件，用
plugin:install；想把它当 Composer 包统一管理（比如配合 CI/CD），得手动 symlink 或改composer.json的repositories+autoload路径 -
plugin:install装的插件，其自身依赖仍需在插件内composer.json声明，否则运行时报错 - 别混用：先
plugin:install再去插件目录composer require第三方包，没问题；反过来，先composer require插件到vendor/，再指望plugin:install找到它，不行
主题里用 composer require 报错 “package not found”，怎么办？
主题目录下执行 composer require 报 Could not find a composer.json 或 no matching package found，大概率是因为主题目录里没有 composer.json 文件，或者文件里缺必要字段（比如 "name" 或 "type"）。
解决方法不是去根目录操作，而是补全主题自己的配置：
- 在
themes/mytheme/composer.json里至少写：{ "name": "myvendor/mytheme", "type": "october-theme", "description": "My custom theme" } - 确保主题目录权限可写（尤其
vendor/子目录），否则composer require会静默失败 - 如果主题是从 GitHub 拉的，检查
composer.json是否被 .gitignore 掉了——有些主题模板默认忽略它
autoload 生效前，记得清缓存：php artisan cache:clear && php artisan config:clear，否则新引入的类还是找不到。
