讲师中心 微信公众号
AI工具推荐 视频效率加速

Git怎么解决中文乱码_Git配置UTF-8解决中文显示异常【排查】

星晨同学_5915

星晨同学_5915

发布时间:2026-05-01 07:56:48

|

351人浏览过

|

来源于php中文网

原创

根本原因是core.quotepath默认为true,Git将中文等非ASCII字符转义为八进制序列;解决只需执行git config --global core.quotepath false,并确保终端编码为UTF-8(如Windows需chcp 65001),git log乱码则需同步配置i18n.commitencoding、i18n.logoutputencoding及LESSCHARSET。

git怎么解决中文乱码_git配置utf-8解决中文显示异常【排查】

git status 显示中文文件名为八进制转义(如 \344\270\255\346\226\207)

这是 core.quotepath 默认为 true 导致的——Git 把所有非 ASCII 字符(包括中文)强制转成 C 风格的八进制序列,纯属显示层压制,不改存储。

解决只需一条命令:

  • git config --global core.quotepath false(全局生效)
  • 或仅当前仓库:git config core.quotepath false

但注意:设完后仍乱码,大概率是终端没跟上。Windows CMD 必须先执行 chcp 65001 切到 UTF-8;Git Bash / Windows Terminal 默认 OK;macOS/Linux 终端一般无需操作,但建议检查 locale | grep UTF-8 确认输出含 UTF-8。

git log 提交信息或作者名显示为 或方块

这和 core.quotepath 无关,是 Git 读取/输出 commit message 时的编码链断了。关键在三处配置是否对齐:

  • git config --global i18n.commitencoding utf-8(告诉 Git:你存的 commit 是 UTF-8)
  • git config --global i18n.logoutputencoding utf-8(告诉 Git:你输出 log 时也按 UTF-8 解码)
  • export LESSCHARSET=utf-8(加到 ~/.bashrc 或 ~/.zshrc,让分页器 less 正确渲染)

注意:i18n.logoutputencoding 在 Git ≥ 2.31 已标记为弃用,但 Windows 上仍建议保留;macOS/Linux 用户若设 utf-8 无效,可试 en_US.UTF-8。

GitHub 人才猎手 (GitHub Talent Hunter)
GitHub 人才猎手 (GitHub Talent Hunter)

在GitHub上精准匹配技术人才,自动生成个性化触达话术,适用于招聘、技术合伙人寻找、猎头候选人交付等场景。

下载

Windows 下 git add 中文文件失败,报 “did not match any files”

这不是编码问题,而是 Git 实际没识别到文件路径——常见于旧版 Git(

必须检查并操作以下几点:

  • 运行 git --version,确认 ≥ 2.31;否则升级 Git
  • 执行 git config --global core.protectNTFS false(仅 Windows,关闭 NTFS 保留名检查)
  • 避免混用 CMD 和 Git Bash 操作同一仓库:CMD 默认 GBK,Git Bash 默认 UTF-8,路径解析错位后 Git 根本找不到文件
  • 极端情况可手动编辑 Git 安装目录/etc/gitconfig,追加两行:
    [core]
    outputEncoding = utf-8
    logOutputEncoding = utf-8

远程仓库看到中文文件名变成 %E6%97%A5%E5%B8%B8 这类 URL 编码

说明 Git 已把文件名实际存成了 URL 编码格式,不是显示问题,是底层路径处理失败。典型诱因:

  • Git 版本太老(
  • Windows 上未关 core.protectNTFS,NTFS 拦截后 Git 回退到安全但错误的编码方式
  • 用 VS Code 内置终端提交、却用 CMD 查看状态,环境不一致导致 Git 缓存错乱

修复后务必验证:删掉本地 .git/index,再执行 git read-tree --reset -u HEAD 强制重载索引,否则旧编码残留会持续干扰。

最易被忽略的是终端本身——Git 配得再准,CMD 还卡在 GBK,git status 就永远是方块。别只调 Git,顺手敲 chcp 看当前代码页,再看终端字体是否支持 Unicode。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

5239

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

1600

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

934

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3417

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3101

2024.04.09

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

160

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

80

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

80

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

40

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 7.9万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn