裸Git仓库配置及工作流：向离线机器传输项目变更的实现方案

针对你遇到的Visual Studio项目复制耗时过长的问题，以及想通过裸Git仓库实现离线机器间项目、变更同步的需求，我整理了一套实用的方案——都是日常开发中验证过的技巧：

一、解决VS项目复制耗时过长的问题 #

直接复制整个项目文件夹慢，核心原因是里面包含了大量Git不需要追踪的编译产物、缓存文件，这些文件体积大且没必要同步。可以通过以下方式优化：

• 配置.gitignore过滤冗余文件：在你的VS项目根目录创建.gitignore文件，添加以下规则，确保Git只追踪源码和必要配置：

  # Visual Studio 相关缓存
  *.suo
  *.user
  *.userosscache
  *.sln.docstates
  .vs/
  # 编译产物
  bin/
  obj/
  Debug/
  Release/
  # 其他临时文件
  *.cache
  *.log
  

• 用Git Archive打包干净的项目文件：如果需要把项目传输到离线机器，不要直接复制文件夹，而是在服务器的Git仓库执行以下命令，打包Git追踪的所有文件：

  git archive --format=zip --output=project-latest.zip main
  

  这个zip文件只包含必要的源码，体积远小于整个项目文件夹，复制速度会快很多。
• 优先用Git克隆替代手动复制：如果离线机器有Git环境，直接克隆服务器的裸仓库（下文会讲配置），一步到位获取干净的项目代码，省去手动复制和解压的麻烦。

二、配置裸Git仓库实现离线机器同步工作流 #

裸仓库没有工作目录，专门用于存储版本历史，非常适合作为离线场景下的代码同步介质。以下是完整的配置和工作流：

1. 在服务器上创建裸仓库 #

登录你的服务器，选择一个合适的目录，执行以下命令创建裸仓库：

mkdir /opt/git/project.git
cd /opt/git/project.git
git init --bare

裸仓库的命名通常以.git结尾，方便识别。

2. 关联本地VS项目到服务器裸仓库 #

在你的Windows开发机上，打开Git CLI（可以通过VS的终端或者单独的Git Bash），进入VS项目目录：

# 如果还没初始化本地仓库，先执行
git init
# 添加所有需要追踪的文件（.gitignore会自动过滤冗余内容）
git add .
git commit -m "Initial commit: 初始化VS项目"
# 添加服务器裸仓库作为远程源
git remote add origin ssh://your-username@server-ip:/opt/git/project.git
# 首次推送代码到服务器
git push -u origin main

3. 离线机器获取项目的两种方式 #

方式一：首次从服务器同步到离线机器

如果离线机器无法直接访问服务器，先把服务器的裸仓库打包：

# 在服务器上执行
cd /opt/git
zip -r project-bare.zip project.git/

把project-bare.zip拷贝到离线机器，解压后，在离线机器上克隆这个裸仓库：

git clone /path/to/unzipped/project.git my-project
cd my-project

这样你就得到了一个带工作目录的本地仓库，可以正常进行开发和提交。

方式二：离线机器开发后同步变更回服务器

当离线机器完成开发或Bug修复后，按以下步骤同步变更：

1. 在离线机器的本地仓库提交变更：

   git add .
   git commit -m "修复XXBug，新增XX功能"
   

2. 生成包含所有未同步提交的补丁文件：

   git format-patch origin/main --stdout > offline-changes.patch
   

3. 把offline-changes.patch拷贝到能访问服务器的机器（比如你的Windows开发机），应用补丁：

   cd /path/to/your/vs-project
   git am /path/to/offline-changes.patch
   

4. 最后推送到服务器的裸仓库：

   git push origin main
   

4. 两台离线机器之间直接同步 #

如果需要在两台离线机器之间传递变更，可以用临时裸仓库作为中间介质：

1. 在源离线机器上创建临时裸仓库：

   mkdir /tmp/temp-bare.git
   cd /tmp/temp-bare.git
   git init --bare
   

2. 把本地变更推送到临时裸仓库：

   cd /path/to/local-project
   git remote add temp /tmp/temp-bare.git
   git push temp main
   

3. 把temp-bare.git打包拷贝到目标离线机器，然后拉取变更：

   # 目标机器上如果是新项目，直接克隆
   git clone /path/to/temp-bare.git synced-project
   # 如果已有仓库，添加远程并拉取
   cd existing-project
   git remote add temp /path/to/temp-bare.git
   git pull temp main
   

内容的提问来源于stack exchange，提问作者KDecker