git archive 是最轻量干净的导出方式，直接从仓库历史打包指定 commit/tag 快照，尊重 .gitignore；github/gitlab 需拼接 url 精准下载；composer 导出需配合 composer.lock 复现依赖。
用 Git 检出指定 commit 或 tag 导出代码
如果项目已纳入 Git 管理，git archive 是最轻量、最干净的导出方式——不带 .git 目录，也不依赖工作区状态。它直接从仓库历史中打包某个 commit、branch 或 tag 对应的快照。
常见错误是先 git checkout 再手动复制，这容易混入未提交变更或忽略 .gitignore 规则；而 git archive 默认尊重 .gitignore，且输出可控。
- 导出最新 tag（如 v2.1.0）：
git archive --format=zip --output=project-v2.1.0.zip v2.1.0 - 导出某次 commit（如 a1b2c3d）：
git archive --format=tar.gz --output=project-a1b2c3d.tar.gz a1b2c3d - 只导出
src/和config/目录：git archive --format=zip --output=partial.zip a1b2c3d -- src/ config/
从 GitHub / GitLab 页面直接下载 zip 包
适合没本地 Git 环境，或只需快速获取公开仓库某版本的情况。但要注意：页面上“Download ZIP”按钮默认下载 main 或 master 分支最新版，不是任意版本。
必须手动拼接 URL 才能精准定位：
立即学习“PHP免费学习笔记（深入）”；
- GitHub tag 下载：
https://github.com/username/repo/archive/refs/tags/v2.1.0.zip - GitHub commit 下载：
https://github.com/username/repo/archive/a1b2c3d456789012345678901234567890123456.zip - GitLab 类似，但路径为
/-/archive/，例如：https://gitlab.com/username/repo/-/archive/v2.1.0/repo-v2.1.0.zip
注意：部分私有仓库需加 personal access token 才能访问该链接，否则返回 404 或重定向到登录页。
用 Composer export 命令导出锁定版本（适用于 PHP 包管理项目）
如果项目用 composer install 安装依赖，且 composer.lock 已提交，可借助 composer create-project + --stability=stable 或直接解包 vendor/ ——但更稳妥的是用 composer install --no-dev --prefer-dist 配合干净目录，再压缩整个项目。
真正适合“导出某个版本”的场景其实是：你想复现某次线上部署时的确切依赖组合。这时不能只导代码，还要固化 composer.lock 中记录的每个包的 exact commit hash 或 version。
- 确保
composer.lock与目标版本一致（比如从对应 commit 中检出该文件） - 新建空目录，复制
composer.json和composer.lock - 运行：
composer install --no-dev --prefer-dist --optimize-autoloader - 再整体压缩：此时
vendor/内容与当时部署完全一致
忽略 .git 目录但保留其他隐藏文件（如 .env.example）
git archive 默认排除所有被 .gitignore 忽略的文件，包括 .env.example 这类需要随发布分发的文件——除非它们没被 ignore。这是最容易踩的坑。
解决方法只有两个：
- 临时注释掉
.gitignore中相关行，再运行git archive（操作完记得还原） - 改用
tar或zip手动打包，并显式包含：tar --exclude='.git' -czf export.tgz .，但要小心遗漏.gitignore里本该排除的敏感文件（如真实.env）
没有银弹：要么信任 Git 的归档逻辑（需调整 ignore 规则），要么自己控制打包过程（需人工校验内容）。选哪个，取决于你对“可重现性”和“操作便捷性”的优先级判断。
