如何使用 composer create-project --prefer-source 拉取带 .git 目录的项目？

使用 --prefer-source 可从源码创建项目并保留 .git 目录，前提是包的 composer.json 中配置了 source 且可访问；执行如 composer create-project laravel/laravel myapp --prefer-source 后需检查 .git 目录是否存在，结合 --keep-vcs 与 -vvv 更佳。

使用 composer create-project --prefer-source 可以从源码创建项目，同时保留版本控制信息（如 .git 目录），前提是包的源地址是通过 Git 等 VCS 托管的，并且 Composer 能正确识别并克隆源。

1. 使用 --prefer-source 的作用

--prefer-source 告诉 Composer 优先从项目的源代码仓库（如 GitHub、GitLab）克隆项目，而不是下载打包的压缩文件（dist）。这样会包含完整的 .git 目录，便于后续开发和提交。

• 你想基于某个开源项目二次开发
• 需要修改依赖包并提交更改
• 希望保留原始提交历史

2. 基本命令格式

运行以下命令：

例如，创建 Laravel 项目并保留 .git：

执行后，Composer 会尝试从源（如 GitHub 的 Git 仓库）克隆代码，而非下载 zip 包。

3. 确保能拉取到 .git 目录的关键点

并不是所有情况下都会生成 .git 目录。需满足以下条件：

• 包的 composer.json 中定义了 source：维护者必须在包中配置 "source" 字段指向 Git 仓库
• 你有权限访问该仓库：私有仓库需要配置 SSH 或 OAuth token
• 网络可访问 Git 服务：如 github.com、gitlab.com 等

示例 source 配置：

Voicepods

Voicepods是一个在线文本转语音平台，允许用户在30秒内将任何书面文本转换为音频文件。

93

查看详情

4. 验证是否成功获取 .git

项目创建完成后，进入目录检查：

如果看到 .git/ 目录，说明源码克隆成功。你可以执行 git log、git status 等操作。

若没有 .git 目录，可能是 Composer 回退到了 dist 下载。可通过增加 -vvv 查看详细日志：

5. 其他建议

• 使用 SSH 地址更稳定：确保全局配置了 SSH 密钥，避免 HTTPS 认证问题
• 指定版本或分支：加上版本号更精确，如 dev-main 或 1.0.0
• 结合 --keep-vcs 使用：明确保留版本控制信息（Composer 2+ 更支持）

例如：

基本上就这些。只要包支持源码安装，--prefer-source 就能帮你拿到带 .git 的完整项目。不复杂但容易忽略配置细节。

以上就是如何使用 composer create-project --prefer-source 拉取带 .git 目录的项目？的详细内容，更多请关注php中文网其它相关文章！