TYPO3 CMS 项目必须用 Composer 管理所有扩展和依赖，禁止手动复制文件；新项目用 composer create-project typo3/cms-base-distribution 初始化，扩展统一通过 composer require 安装，私有扩展需配置 vcs 或 path 类型仓库，并确保 typo3/cms-composer-installers 正确启用。
在 TYPO3 CMS 项目中，用 Composer 管理扩展和依赖是现代开发的标准做法，它能确保版本可控、依赖清晰、部署可重复。核心原则是：所有扩展（包括官方、第三方和自建）都应作为 Composer 包引入，不手动复制文件到 typo3conf/ext/。
初始化 Composer 项目并安装 TYPO3 核心
新项目推荐从官方骨架启动：
- 运行
composer create-project typo3/cms-base-distribution my-site，自动拉取最新稳定版 TYPO3 及基础配置 - 该命令生成标准目录结构，
web/为 Web 根目录，vendor/存放所有 PHP 依赖，typo3conf/ext/保持为空——扩展由 Composer 自动安装到vendor/并软链接或复制到正确位置 - 若迁移旧项目，先执行
composer init初始化composer.json，再用composer require typo3/cms-core:^12（按需指定主版本）引入核心
安装和管理扩展（Extensions）
TYPO3 扩展已全部迁移到 Packagist，安装方式统一为 composer require：
- 安装官方扩展：如
composer require typo3/cms-fluid-styled-content - 安装第三方扩展：如
composer require b13/container（注意包名通常不含typo3-ter/前缀，Packagist 已标准化） - 升级扩展：运行
composer update vendor/package-name（例如composer update friendsoftypo3/flux），避免全量更新引发意外 - 卸载扩展：先在后台停用并删除数据（如必要），再执行
composer remove vendor/package-name（Composer 2.2+ 支持），或手动删require行后composer install
处理私有扩展与本地开发
自有扩展不能直接发布到 Packagist 时，需配置自定义仓库：
- 在
composer.json的repositories字段添加类型为vcs的 Git 仓库，例如："repositories": [{"type": "vcs", "url": "https://git.example.com/my-company/my-extension.git"}] - 确保扩展根目录含合法
composer.json，且type设为typo3-cms-extension，如：{"name": "my-company/my-extension", "type": "typo3-cms-extension", "require": {"typo3/cms-core": "^12"}} - 本地快速测试可用
path类型仓库，指向本地文件夹，适合开发阶段：{"type": "path", "url": "../my-local-extensions/*"}
关键配置与常见注意事项
让 Composer 与 TYPO3 协同工作，需确认几个关键点：
-
typo3/cms-composer-installers必须存在（新项目默认包含），它负责将typo3-cms-extension类型包正确安装到typo3conf/ext/ - 启用
typo3/cms-composer-installers的symlink模式（在composer.json中设"extra": {"typo3/cms": {"symlinks": true}}），可加快开发时的修改反馈 - 生产环境部署前务必运行
composer install --no-dev --optimize-autoloader，减少体积并提升性能 - 避免混用 Extension Manager（EM）安装和 Composer 安装——EM 会绕过 Composer，导致状态不一致；后台仅用于启用/禁用、配置，不用于安装
基本上就这些。Composer 不是 TYPO3 的附加选项，而是其现代部署与协作的基础。只要坚持“所有扩展走 Composer”，就能大幅降低环境差异、升级风险和团队协同成本。
