将 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，以便能加载新依赖。

基本上就这些。完成迁移后，团队不再需要处理子模块同步问题，依赖版本也能统一管理。