如何将本地修改的.git/description文件上传至Git远程仓库？

核心原因 #

.git/description是Git仓库的元数据文件，存放于本地仓库的.git目录下，而Git默认不会追踪.git目录内的文件——这就是你修改后git status无反应、推送后远程仓库也不同步的根本原因。

解决方案 #

1. 直接远程修改（最直接） #

如果能直接访问远程仓库的文件系统（或通过SSH连接到托管仓库的服务器），可以直接编辑远程仓库的描述文件：

• 对于裸仓库，描述文件直接位于仓库根目录（比如test-remote/description），无需进入.git目录：

  # 示例：通过SSH修改远程裸仓库的描述
  ssh your-server-user@server-ip "echo '你的仓库描述' > /path/to/remote-repo/description"
  

2. 用Git钩子实现自动同步（适合批量仓库） #

如果需要通过本地提交推送来同步描述，可以维护一个纳入版本控制的普通文件，再通过远程钩子自动同步到.git/description：

本地操作：

在本地仓库根目录创建一个普通文件（比如REPO_DESCRIPTION），写入描述并提交推送：

echo "你的仓库描述" > REPO_DESCRIPTION
git add REPO_DESCRIPTION
git commit -m "更新仓库描述"
git push origin master

远程仓库配置钩子：

进入远程裸仓库目录，创建hooks/post-receive文件，写入以下内容：

#!/bin/sh
# 从master分支读取REPO_DESCRIPTION的内容，同步到仓库描述文件
git show master:REPO_DESCRIPTION > description

给钩子文件添加执行权限：

chmod +x hooks/post-receive

之后每次推送包含REPO_DESCRIPTION的提交，远程仓库的描述会自动更新，一次配置后无需重复操作，适合批量管理多个仓库。

3. Git新版本的原生支持情况 #

截至Git 2.45版本，官方仍未提供直接将.git/description纳入版本控制并推送的原生功能，因为该文件属于仓库元数据范畴，不属于工作区可追踪内容。因此上述两种方法是当前更高效的替代方案，比旧的符号链接方法更适合批量场景。

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