确认子模块为合规Composer包并发布至可访问仓库；2. 删除子模块目录及Git跟踪信息并提交；3. 通过composer require引入该包，私有包需先配置repositories；4. 调整代码使用Composer自动加载，替换原有相对路径引用为命名空间导入，确保功能一致且依赖更清晰。
将 Git 子模块项目改用 Composer 管理，核心是移除子模块并将其作为 Composer 包引入。整个过程需要确保代码功能不变，同时依赖管理更清晰。
1. 确认子模块项目已发布到 Composer 可访问的仓库
目标子模块必须是一个符合 Composer 规范的 PHP 包，并托管在 Packagist 或私有包仓库（如 Satis、Private Packagist）中。
检查项：
- 子模块根目录包含 composer.json 文件，且定义了正确的
name、type、autoload等字段 - 项目已打标签（如 v1.0.0），因为 Composer 通常按版本安装
- 包已提交到 Packagist 或你的私有仓库可被发现
2. 移除 Git 子模块
在主项目中执行以下步骤：
- 删除子模块目录：rm -rf your-submodule-path
- 从 .gitmodules 文件中移除对应条目
- 从 Git 中取消跟踪子模块：git rm --cached your-submodule-path
- 提交变更：git commit -m "Remove submodule"
3. 使用 Composer 安装原模块
在主项目的根目录执行：
composer require vendor/package-name
如果包未公开，需先在主项目的 composer.json 中配置仓库：
"repositories": [
{
"type": "vcs",
"url": "https://your-git-server.com/vendor/package.git"
}
]
然后运行 require 命令即可安装。
4. 调整代码中的引用路径
如果之前通过相对路径加载子模块类或文件，现在应使用 Composer 的自动加载机制。
例如：
- 旧方式：require_once 'submodule/src/SomeClass.php';
- 新方式：使用命名空间 + Composer autoloader，直接 use Vendor\Package\SomeClass;
确保主项目的 composer.json 正确配置 autoload，以便能加载新依赖。
基本上就这些。完成迁移后，团队不再需要处理子模块同步问题，依赖版本也能统一管理。
