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 VendorModuleNameModelSomeClass 验证类是否能被自动加载
- 若提示“Package not found”，检查
composer.json中的minimum-stability是否为stable，或扩展是否仅发布在beta版本
