Magento 2扩展必须通过Composer管理，安装需配置仓库并执行composer require，启用模块需运行bin/magento module:enable及setup:upgrade等命令，更新用composer update，卸载用composer remove并执行setup:upgrade。
在Magento 2中，所有官方和第三方扩展都应通过Composer安装、更新和卸载，这是唯一被官方支持的扩展管理方式。直接复制文件或手动修改代码会导致升级失败、依赖冲突和安全风险。
安装扩展（含认证与仓库配置）
多数商业扩展需要私有仓库访问权限。先确保已配置Magento官方仓库和扩展提供商的仓库：
- 运行composer config repositories.magento composer https://repo.magento.com添加官方源（首次安装Magento时通常已存在）
- 若扩展来自第三方（如Amasty、Mageplaza），按其文档添加对应私有仓库，例如：
composer config repositories.amasty composer https://packages.amasty.com - 执行composer require vendor/module-name:1.2.3安装指定版本（版本号可省略，Composer会自动选兼容版本）
- 安装过程中提示输入Public Key / Private Key时，前往Magento Marketplace → My Profile → Access Keys 获取并粘贴
启用、禁用与部署模块
Composer只负责下载代码，还需通过Magento命令激活功能：
- 查看已安装但未启用的模块：bin/magento module:status | grep -v "List of enabled modules"
- 启用模块：bin/magento module:enable Vendor_ModuleName（模块名需与
etc/module.xml中一致） - 禁用模块：bin/magento module:disable Vendor_ModuleName（不推荐直接删代码，禁用后仍保留配置）
- 刷新依赖与生成代码：bin/magento setup:upgrade && bin/magento setup:di:compile && bin/magento setup:static-content:deploy -f
更新与移除扩展的安全操作
避免直接删vendor目录或修改composer.json手动编辑：
- 升级单个扩展：composer update vendor/module-name --with-dependencies（
--with-dependencies确保关联包同步更新） - 升级全部扩展：composer update（生产环境慎用，建议先在开发环境测试）
- 卸载扩展：composer remove vendor/module-name（自动触发
uninstall脚本，清理数据库表/配置项） - 卸载后必须执行：bin/magento setup:upgrade && bin/magento cache:clean
常见问题与验证技巧
遇到安装失败或模块不生效？快速定位：
- 检查composer show vendor/module-name确认版本与路径是否正确
- 查看vendor/composer/installed.json确认模块是否真正写入依赖清单
- 运行bin/magento dev:di:info Vendor\ModuleName\Model\SomeClass验证类是否能被自动加载
- 若提示“Package not found”，检查
composer.json中的minimum-stability是否为stable，或扩展是否仅发布在beta版本
