Blog on GitFAQ中文网

Git for Windows v2.56.0.windows.4发布

Sun, 25 Oct 2026 19:34:12 +0800

Git for Windows v2.56.0.windows.4发布

自 Git for Windows v2.56.0(3)（2026年10月22日）以来的变更

这是又一个紧急安全漏洞修复版本，针对的是CVE-2026-111497。

问题修复

32 位 MinGit 中包含的可执行文件存在代码签名损坏的问题，现已修复。
将内置的brotli组件升级至 v1.2.1，以解决CVE-2026-111497。

下载Git for Windows

Git常见问题20250507

Wed, 07 May 2025 06:43:12 +0800

git配置

我应该在 user.name 中放什么？

您应该填写您的个人姓名，通常是使用名字和姓氏的形式。例如， Git 的当前维护者使用 “Junio C Hamano” 。这将是您所做的每个提交中存储的姓名部分。

此配置对远程服务的身份验证没有任何影响；有关详细信息，请参阅 git-config[1] 中的 credential.username 。

http.postBuffer 到底起什么作用？

此选项可更改 Git 通过 HTTP 或 HTTPS 将数据推送到远程时使用的缓冲区大小。如果数据大于此大小，处理 Git 的 HTTP 支持的 libcurl 将使用分块传输编码，因为事先不知道推送的数据的大小。

将此值保留为默认大小是可以的，除非您知道远程服务器或中间的代理不支持 HTTP/1.1（引入了分块传输编码）或已知分块数据会中断。这通常（错误地）被建议作为一般推送问题的解决方案，但由于几乎每个服务器和代理都至少支持 HTTP/1.1，因此提高此值通常无法解决大多数推送问题。无法正确支持 HTTP/1.1 和分块传输编码的服务器或代理在当今的互联网上不会那么有用，因为它会中断大量流量。

请注意，增加此值将增加 Git 通过 HTTP 或 HTTPS 执行的每个相关推送所使用的内存，因为无论是否全部使用，都会分配整个缓冲区。因此，最好将其保留为默认值，除非您确定需要不同的值。

git如何配置不同的编辑器？

如果您没有为 Git 专门指定编辑器，它将默认使用您通过 VISUAL 或 EDITOR 环境变量配置的编辑器，如果两者都未指定，则使用系统默认编辑器（通常为 vi ）。由于有些人发现 vi 难以使用或更喜欢其他编辑器，因此可能需要更改使用的编辑器。

如果要为大多数需要编辑器的程序配置通用编辑器，可以编辑 shell 配置（例如 ~/.bashrc 或 ~/.zshenv ），使其包含一行，将 EDITOR 或 VISUAL 环境变量设置为适当的值。例如，如果您更喜欢编辑器 nano ，则可以编写以下内容：

GitHub发布Release详尽指南

Wed, 01 Jan 2025 15:00:12 +0800

在开发过程中，发布 Release 是一个重要的环节，能够有效地管理软件的版本和交付。本文将详细介绍如何在 GitHub 上发布 Release，包括操作步骤、注意事项及常见问题解答。

什么是GitHub Release

GitHub Release 是 GitHub 提供的一项功能，用于管理项目的发布版本。每一个 Release 都可以附带二进制文件、源代码压缩包以及变更日志，方便用户下载和使用。通过 Release，开发者能够清晰地展示项目的进展，并为用户提供稳定的版本。

为什么要在 GitHub 上发布 Release

版本管理：使用 Release 可以帮助开发者对项目进行有效的版本管理。
便于用户下载：用户可以轻松找到适合自己的版本进行下载。
信息透明：Release 说明可以让用户了解到版本更新的内容与改动。

如何在 GitHub 上发布 Release

第一步：准备工作

在发布 Release 之前，需要确保你的项目已经完成了相应的功能开发和测试。

确保代码稳定：确认你的代码已经经过充分测试，能够正常运行。
更新文档：确保项目的文档（如 README 文件）是最新的，并且描述了新版本的主要特性。

第二步：创建 Tag

登录到你的 GitHub 账号，进入需要发布 Release 的项目页面。
点击页面上方的 “Code” 选项卡。
在页面右侧，找到 “Releases” 链接，点击进入。
点击 “Draft a new release” 按钮。
在 “Tag version” 输入框中输入新的 Tag 名称（例如 v1.0.0）。
选择相应的基础分支（通常是 main 或 master）。

第三步：填写 Release 信息

在创建 Release 页面中，需要填写一些关键信息：

Git实用命令详解

Thu, 19 Sep 2024 09:34:12 +0800

将本地项目推送到远程仓库

git init（初始化）
git remote -v (查看已经关联的地址)
git add . （添加本地仓库）
git commit -m "第一次提交"（提交说明）
git remote add origin xxx（关联远程仓库）
git pull --rebase origin master（同步本地与远程仓库）
git push -u origin master（提交远程仓库）-f：强制推送至远程

Git回退到某个历史版本

找到要回退的版本号(右击项目–> Git –> Show History –>选中要回退的版本–>Copy Revision Number)

git reset --hard 139dcfaa558e3276b30b6b2e5cbbb9c00bbdca96 (后面为版本号)

把修改推到远程服务器

git push -f -u origin master 或者 git push -f 强制同步远程仓库。

修改项目关联远程地址方法

修改命令

git remote set-url origin <url>

手动修改

项目.git文件夹下，编辑config配置文件中url

Git 修改分支的名称

需要将分支br_rename_old修改为br_rename_new，执行如下步骤：

执行命令git checkout br_rename_old切换到br_rename_old分支，如果已经在这个分支下，可以不执行此步骤
执行命令git pull origin br_rename_old将代码更新到和远程仓库一致
执行命令git branch -m br_rename_old br_rename_new将本地仓库的br_rename_old的名称修改为br_rename_new
执行命令git push --set-upstream origin br_rename_new将本地分支push到远程仓库
执行命令git push origin --delete br_rename_old将远程分支br_rename_old删除

Git 删除分支

我现在在dev20181018分支上，想删除dev20181018分支

修改Git远程URL

Wed, 14 Aug 2024 09:34:12 +0800

查看当前远端地址

$ git remote -v
origin ssh://ov@git.zjq.xyz:29/ex.git (fetch)
origin ssh://ov@git.zjq.xyz:29/ex.git (push)

修改新的远端地址

git remote set-url origin ssh://vo@git.jidan.org:29/ex.git

验证修改结果

$ git remote -v
origin ssh://vo@git.jidan.org:29/ex.git (fetch)
origin ssh://vo@git.jidan.org:29/ex.git (push)

下来就可以Push最新修改

On branch master
Your branch is ahead of 'origin/master' by 1 commit.
 (use "git push" to publish your local commits)

nothing to commit, working tree clean
The authenticity of host '[git.jidan.org]:29 ([8.8.8.8]:29)' can't be established.
ED25519 key fingerprint is SHA256:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.
This host key is known by the following other names/addresses:
 ~/.ssh/known_hosts:6: [git.zjq.xyz]:29
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[git.jidan.org]:29' (ED25519) to the list of known hosts.
Enumerating objects: 39, done.
Counting objects: 100% (39/39), done.
Delta compression using up to 4 threads
Compressing objects: 100% (23/23), done.
Writing objects: 100% (23/23), 10.86 MiB | 3.13 MiB/s, done.
Total 23 (delta 4), reused 0 (delta 0), pack-reused 0 (from 0)
To ssh://git.jidan.org:29/ex.git
 17ae34c..b8ae5da master -> master
Push Done!

如何最简便的搭建Git服务?

Thu, 25 Jul 2024 17:18:12 +0800

假设你有个绑定域名为git.gitfaq.cn的服务器，并且可以通过SSH登录,计划将所有仓库(repository)放到/data/git目录中。

建立仓库(repository)

本地新建仓库(repository)

mkdir repo.git
git init

将仓库(repository)上传到服务器中。

scp -r repo.git user@git.gitfaq.cn:/data/git

成功后，即可通过user@git.gitfaq.cn:/data/git/repo.git来访问远端仓库。

访问仓库(repository)

建立好仓库后，拥有SSH权限的user就可以对user@git.gitfaq.cn:/data/git/repo.git拥有操作权限。

还可以通过git init --shared设置仓库目录的组权限为可写，此命令不会影响任何提交、引用等内容。

ssh user@git.gitfaq.cn
cd /data/git/repo.git
git init --bare --shared

如果需要多个用户都对仓库有读写权限，又不能给每个用户在服务器上建立账户，那么提供 SSH 连接就是唯一的选择。假设用来共享仓库的服务器已经安装了 SSH 服务，而且你通过它访问服务器。

以下几个方法可以使你给团队每个成员提供访问权:

给每个人创建账号，为每个人运行一次 adduser（或者 useradd）并且设置密码。
在主机上建立一个 git 公用账户，每个需要权限的人发一个 SSH 公钥，然后将其加入 git 账户的 ~/.ssh/authorized_keys 文件。这样一来，所有人都将通过 git账户访问主机。
让 SSH 服务器通过某个 LDAP 服务，或者其他已经设定好的集中授权机制，来进行授权。只要每个用户可以获得主机的 shell 访问权限，任何 SSH 授权机制你都可视为是有效的。

初次使用 Git 的一些配置

Thu, 25 Jul 2024 16:46:12 +0800

安装完Git，你会想要做几件事来定制你的 Git 环境。每台计算机上只需要配置一次，程序升级时会保留配置信息。你可以在任何时候再次通过运行命令来修改它们。

git配置管理

Git 自带一个 git config 的工具来帮助设置控制 Git 外观和行为的配置变量。这些变量存储在三个不同的位置：

/etc/gitconfig 文件: 包含系统上所有用户及他们仓库的通用配置。如果在执行 git config 时带上 --system 选项，那么它就会读写该文件中的配置变量。（需要管理员或超级用户权限）
~/.gitconfig 或 ~/.config/git/config 文件：只针对当前用户。你可以传递 --global 选项让 Git 读写此文件，这会对你系统上所有的仓库生效。
当前使用仓库的 Git 目录中的 config 文件（即 .git/config）：针对当前仓库。你可以传递 --local 选项让 Git 强制读写此文件，虽然默认情况下用的就是它。（需要进入某个 Git 仓库中才能让该选项生效。）

每一个级别会覆盖上一级别的配置，所以 .git/config 的配置变量会覆盖 /etc/gitconfig 中的配置变量。

在 Windows 系统中，Git 会查找 $HOME 目录下（一般情况下是 C:\Users$USER ）的 .gitconfig 文件。 Git 同样也会寻找 /etc/gitconfig 文件，但只限于 MSys 的根目录下，即安装 Git 时所选的目标位置。如果你在 Windows 上使用 Git 2.x 以后的版本，那么还有一个系统级的配置文件，Windows XP 上在 C:\Documents and Settings\All Users\Application Data\Git\config ，Windows Vista 及其以后的版本在 C:\ProgramData\Git\config 。此文件只能以管理员权限通过 git config -f <file> 来修改。

zsh中使用git的一些配置建议

Thu, 25 Jul 2024 11:40:12 +0800

Zsh 为 Git 提供了一个 Tab 补全库。想要使用它，只需在你的 .zshrc 中执行 autoload -Uz compinit && compinit 即可。相对于 Bash，Zsh 的接口更加强大：

$ git che<Tab>
check-attr -- 显示 gitattributes 信息
check-ref-format -- 检查引用名称是否符合规范
checkout -- 从工作区中检出分支或路径
checkout-index -- 从暂存区拷贝文件至工作目录
cherry -- 查找没有被合并至上游的提交
cherry-pick -- 从一些已存在的提交中应用更改

有歧义的 Tab 补全不仅会被列出，它们还会有帮助性的描述，你可以通过不断敲击 Tab 以图形方式浏览补全列表。该功能可用于 Git 命令、它们的参数和在仓库中内容的名称（例如 refs 和 remotes），还有文件名和其他所有 Zsh 知道如何去补全的项目。

Zsh 提供了一个从版本控制系统中获取信息的框架，叫做 vcs_info 。把如下代码添加至你的 ~/.zshrc 文件中，就可以在右侧显示分支名称：

autoload -Uz vcs_info
precmd_vcs_info() { vcs_info }
precmd_functions+=( precmd_vcs_info )
setopt prompt_subst
RPROMPT=\$vcs_info_msg_0_
# PROMPT=\$vcs_info_msg_0_'%# '
zstyle ':vcs_info:git:*' formats '%b'

当你的命令行位于一个 Git 仓库目录时，在任何时候，都可以在命令行窗口右侧显示当前分支。（当然也可以在左侧显示，只需把上面 PROMPT 的注释去掉即可。）它看起来像这样：

为什么windows下文本文件被检测为二进制文件？

Thu, 25 Jul 2024 10:23:12 +0800

当您将文本文件存储为 UTF-8 时，Git 效果最佳。Windows 上的许多程序都支持 UTF-8，但有些程序不支持，并且仅使用小端 UTF-16 格式，Git 将其检测为二进制文件。如果您无法在程序中使用 UTF-8，则可以指定一个工作树编码，指示应使用哪个编码签出您的文件，同时仍将这些文件作为 UTF-8 存储在存储库中。这允许像 git-diff这样的工具按预期工作，同时仍允许您的工具工作。

为此，您可以使用具有 working-tree-encoding 属性的 gitattributes 模式。例如，以下模式将所有 C 文件设置为使用 UTF-16LE-BOM，这是 Windows 上常见的编码

*.c	working-tree-encoding=UTF-16LE-BOM

您需要运行 git add --renormalize 以使其生效。请注意，如果您在跨平台使用的项目上进行这些更改，您可能希望在按用户配置的文件中或在 $GIT_DIR/info/attributes 中进行更改，因为在存储库中的 .gitattributes 文件中进行更改将适用于存储库的所有用户。

另请参阅以下条目以获取有关规范换行符的信息，并参阅 gitattributes以获取有关属性文件的更多信息。

via https://gitfaq.org/1/01/how-do-i-add-only-a-portion-of-a-file/

为什么我有一个总是被修改的文件?

Thu, 25 Jul 2024 10:04:12 +0800

在内部，Git 始终将文件名存储为字节序列，并且不执行任何编码或大小写转换。但是，Windows 和 macOS 默认情况下都对文件名执行大小写转换。因此，最终可能会出现多个文件或目录，其名称仅在大小写上有所不同。Git 可以很好地处理这种情况，但文件系统只能存储其中一个文件，因此当 Git 读取另一个文件以查看其内容时，它看起来已被修改。

最好删除其中一个文件，以便您只有一个文件。您可以使用以下命令（假设在其他干净的工作树上存在两个文件 AFile.txt 和 afile.txt）执行此操作

$ git rm --cached AFile.txt
$ git commit -m 'Remove files conflicting in case'
$ git checkout .

这样可以避免接触磁盘，但会删除附加文件。你的项目可能更喜欢采用命名约定，例如全小写名称，以避免此问题再次发生；可以使用pre-receive钩子或作为持续集成 (CI) 系统的一部分来检查此类约定。

如果你的系统正在使用污点或清理过滤器，但之前已提交文件而未运行污点或清理过滤器，则任何平台上都可能出现永久修改的文件。要解决此问题，请在其他干净的工作树上运行以下内容

$ git add --renormalize .

via https://git.js.cn/docs/gitfaq

Git 中存储文件的推荐方法是什么?

Thu, 25 Jul 2024 09:51:12 +0800

虽然 Git 可以存储和处理任何类型的任何文件，但有些设置比其他设置效果更好。一般来说，我们建议将文本文件存储在 UTF-8 中，不带字节顺序标记 (BOM)，并带有 LF（Unix 样式）结尾。我们还建议在提交消息中使用 UTF-8（同样，不带 BOM）。这些设置在各个平台上以及与git diff和git merge等工具配合使用时效果最佳。

此外，如果你可以在基于文本或非基于文本的存储格式之间进行选择，我们建议将文件存储在文本格式中，并在必要时将它们转换为其他格式。例如，每行一个记录的基于文本的 SQL 转储将比实际数据库文件更适合于差异和合并。类似地，基于文本的格式（如 Markdown 和 AsciiDoc）将比二进制格式（如 Microsoft Word 和 PDF）效果更好。

类似地，通常不建议在存储库中存储二进制依赖项（例如共享库或 JAR 文件）或构建产品。最好将依赖项和构建产品存储在工件或包服务器上，只将引用、URL 和哈希存储在存储库中。

我们还建议设置一个gitattributes文件来明确标记哪些文件是文本文件，哪些是二进制文件。如果你希望 Git 猜测，你可以设置属性text=auto。例如，以下内容可能适用于某些项目

# By default, guess.
*	text=auto
# Mark all C files as text.
*.c	text
# Mark all JPEG files as binary.
*.jpg	binary

这些设置帮助工具为输出（例如补丁）选择正确的格式，并导致文件以适合该平台的行尾签出。

via https://git.js.cn/docs/gitfaq

Windows下如何安装Git?

Thu, 25 Jul 2024 09:34:12 +0800

Windows下安装Git需要在https://git-scm.com/download下载git for windows安装包

进入以上页面后，找到如下处，点击Download for Windows开始下载

随后进入开始下载页面，但是从github源地址下载，国内访问异常的话可以点击这里通过国内线路下载。

git scm历史版本

Git-2.47.0.2-32-bit.exe (访问密码: 3705)
Git-2.47.0.2-32-bit.exe (访问密码: 3705)

安装完成后，在任意目录右键，点击Open Git Bash here打开terminal，输入git version查看当前git版本

alair@e64 MINGW64 /d/dt2
$ git version
git version 2.45.2.windows.1

Git中fetch和pull有什么不同之处？

Wed, 24 Jul 2024 17:20:12 +0800

git pull [remote] [branch] 等同于如下操作

## 从远程仓库获取最新修改
git fetch [remote] [branch] 
## 合并最新修改
git merge [remote][/branch]

git pull --rebase [remote] [branch]等同于如下操作

## 从远程仓库获取最新修改
git fetch [remote] [branch]
git rebase [remote][/branch]

via https://gitfaq.org/1/01/what-is-the-difference-between-fetch-and-pull/

如何仅添加文件的部分内容？

Wed, 24 Jul 2024 16:50:12 +0800

git add --patch <file>

使用该命令会打开一个交互式界面，将每处不同的地区按照区块(hunk)的方式逐一显示，并提示你如何处理，从而达到仅添加部分内容的目的。

git add --patch package.json
diff --git a/package.json b/package.json
index 7a558a3..e03ce3f 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,6 @@
 "name": "package",
 "version": "0.4.3",
 "description": "this is an example package",
- "keywords": ["key", "middleware", "connect"],
 "repository": "git://github.com/foo/bar.git",
 "author": "jxt <info@gitfaq.cn> (http://gitfaq.cn)",
 "repository": "git://github.com/foo/bar",
Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? y

Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]? 提示如何处理当前区块(hunk)，输入?可查看帮助信息

y - stage this hunk 暂存此区块
n - do not stage this hunk 不暂存此区块
q - quit; do not stage this hunk or any of the remaining ones 退出；不暂存包括此块在内的剩余的区块
a - stage this hunk and all later hunks in the file 暂存此块与此文件后面所有的区块
d - do not stage this hunk or any of the later hunks in the file 不暂存此块与此文件后面所有的区块
g - select a hunk to go to 选择并跳转至一个区块
/ - search for a hunk matching the given regex 搜索与给定正则表达示匹配的区块
j - leave this hunk undecided, see next undecided hunk 暂不决定，转至下一个未决定的区块
J - leave this hunk undecided, see next hunk 暂不决定，转至下一个区块
k - leave this hunk undecided, see previous undecided hunk 暂不决定，转至上一个未决定的区块
K - leave this hunk undecided, see previous hunk 暂不决定，转至上一个区块
s - split the current hunk into smaller hunks 将当前的区块分割成多个较小的区块
e - manually edit the current hunk 手动编辑当前的区块
? - print help 输出帮助

via https://gitfaq.org/1/01/how-do-i-add-only-a-portion-of-a-file/

Git如何设置代理?

Wed, 24 Jul 2024 16:43:12 +0800

GIT配置代理如下设置，socks5为代理协议，可配置http/https/socks5等。

 git config --global http.proxy socks5://127.0.0.1:20170

git writing objects 卡死怎么办?

Wed, 24 Jul 2024 16:30:12 +0800

git writing objects时常卡死，可以试着将远端地址改为ssh方式再重新push

git remote set-url origin git@gitlab.com:username/repo.git

如何归档备份Git内容?

Wed, 24 Jul 2024 15:53:12 +0800

想将当前版本的内容归档并备份，可以使用git archive命令来实现

归档当前master，然后压缩成zip文件。

git archive --format=zip --output=repobak_$(date +%Y-%m-%d).zip master