Git 踩坑记录

1 文件/目录大小写问题(Windows/macOS)

Git 默认对大小写不敏感,修改文件夹大小写可能无法在远程仓库更新。

方法 1:临时改名

bash 复制代码
git mv FolderName tempname
git commit -m "临时改名"
git push

git mv tempname foldername
git commit -m "改回目标大小写"
git push

方法 2:强制更新

bash 复制代码
git config core.ignorecase false
git add -A
git commit -m "修正大小写"
git push

清除缓存(必要时)

bash 复制代码
git rm -r --cached FolderName
git add foldername
git commit -m "修正大小写"
git push

2 中文路径异常

注意:不考虑 SVN 分支

Git 输出中文路径可能乱码,解决方法:

bash 复制代码
git config --global core.quotepath false

作用:禁用输出路径的引号和转义,使 git status/git log 更易读。

3 SVN 仓库迁移到 Git

bash 复制代码
# 初始化 git-svn 仓库
git svn init https://example.com/svn/repo

# 拉取指定版本及作者对应
git svn fetch -A authors.txt -r 0:100 

# 合并 svn 分支到 master
git merge remotes/git-svn

# 回退至指定版本(可选)
git svn reset -r 4000
txt 复制代码
# authors.txt 示例
yaoxin = BeyondXinXin <779354187@qq.com>
VisualSVN Server = BeyondXinXin <779354187@nt.com>

注意:需要完整作者映射表

4 批量替换作者

重写历史时统一作者信息,适合迁移或整理历史仓库。

注意:执行前一定要备份仓库,否则历史被重写无法恢复。

bash 复制代码
# 1. 安装工具
python install git-filter-repo

# 2. 将可执行程序放到 Git 执行目录(Windows 示例)
# C:\Users\HP\AppData\Roaming\Python\Python312\Scripts\git-filter-repo.exe
# C:\Program Files\Git\bin\git-filter-repo.exe

# 3. 创建映射文件 mailmap.txt
# 内容示例:
# BeyondXin <779354187@qq.com>

# 4. 执行替换(提前备份仓库,如果不用 --force 需要先 clone 新仓库)
git filter-repo --mailmap ../mailmap.txt --force

# 5. 清除引用标记
:: delete_replaces.bat
@echo off
for /f "delims=" %%i in ('git replace -l') do (
    git replace -d %%i
)
相关推荐
七分辣度6 小时前
GitHub/Git 常用命令及使用场景
git·github
慧都小项1 天前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任1 天前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
为思念酝酿的痛4 天前
Git基本操作
git·github
wno7045 天前
常用的Git命令清单
大数据·git·elasticsearch
真上帝的左手5 天前
3. 代码管理-Git-进阶
git·源代码管理
YIN_尹5 天前
【git原理与使用】git基本操作及底层原理(二)
大数据·git·elasticsearch
程序员爱德华6 天前
Git 命令
git
Cry丶6 天前
Git Rebase 操作备忘
git·rebase
你叶不叶6 天前
abap git 如何从 gitee上在线拉取数据(上一步已经配置好证书)
git·gitee·sap·abapgit