当前位置: 首页 > news >正文

Git 中文文件名显示为转义码(乱码)的解决方案

问题描述

在使用 Git 时,如果文件名包含中文或其他非 ASCII 字符,执行 git status 等命令时会看到类似这样的输出:

$ git status
On branch main
Untracked files:(use "git add <file>..." to include in what will be committed)"\350\256\242\345\215\225\347\256\241\347\220\206.txt""\347\224\250\346\210\267\346\225\260\346\215\256/\344\270\252\344\272\272\344\277\241\346\201\257.json""\346\226\207\346\241\243/\351\241\271\347\233\256\350\257\264\346\230\216.md"

这些 \xxx 格式的内容并不是乱码,而是 Git 将非 ASCII 字符进行了八进制转义显示。

原因分析

Git 默认会对路径中的非 ASCII 字符进行转义,这是为了:

  • 避免在某些终端上显示异常
  • 保证在不同系统间的兼容性
  • 防止特殊字符引起的问题

这个行为由 Git 的 core.quotepath 配置项控制,默认值为 true

解决方案

设置不转义中文字符

执行以下命令,让 Git 正常显示中文文件名:

git config --global core.quotepath false

参数说明:

  • --global:全局设置,影响所有 Git 仓库
  • core.quotepath false:禁用路径转义

如果只想对当前仓库生效,去掉 --global 参数:

git config core.quotepath false

验证设置

设置后再执行 git status,就能看到正常的中文显示:

$ git status
On branch main
Untracked files:(use "git add <file>..." to include in what will be committed)订单管理.txt用户数据/个人信息.json文档/项目说明.md

恢复默认设置

如果想恢复 Git 的默认行为,有两种方式:

方式1:删除配置项

git config --global --unset core.quotepath

方式2:设置为默认值

git config --global core.quotepath true

查看当前配置

查看 core.quotepath 的当前值:

git config --global core.quotepath
  • 返回 false:已禁用转义
  • 返回 true:启用转义(默认)
  • 返回空:未设置(使用默认值 true

补充说明

  1. 配置项名称不区分大小写core.quotepathcore.quotePathCORE.QUOTEPATH 都有效,但推荐使用全小写的标准写法。

  2. 适用范围:此设置影响所有 Git 命令的输出,包括 git statusgit diffgit log 等。

  3. 终端支持:确保你的终端支持 UTF-8 编码,否则即使设置了 core.quotepath false,中文也可能无法正常显示。

  4. 跨平台协作:如果团队成员使用不同操作系统,建议每个人根据自己的终端情况独立配置,不要将此配置加入到项目的 .git/config 中。

总结

遇到 Git 中文文件名显示为转义码的问题,只需一行命令即可解决:

git config --global core.quotepath false

这是一个纯显示层面的设置,不会影响 Git 的实际功能和文件存储,可以放心使用。

http://www.jsqmd.com/news/71400/

相关文章:

  • 真相:大量硬件场景 根本跑不了 Linux
  • Windows-GameBar-ErrorLog
  • S7-PLCSIM Advanced V6.0同网段不同电脑之间网络配置
  • 记录一些波波的话
  • 从“能用”到“卓越”:7个实战技巧提升C#代码质量
  • 2025最新结构胶品牌推荐!国内优质结构胶权威榜单发布,资质服务双优助力高品质建筑山东结构胶服务公司推荐 - 全局中转站
  • 2025最新玻璃胶推荐!国内优质玻璃胶品牌权威榜单发布,资质与性能双优助力高效密封 - 全局中转站
  • 2025最新免钉胶推荐!国内优质免钉胶品牌权威榜单发布,环保性能与粘结强度双优助力高效装修 - 全局中转站
  • 2025 最新美缝剂品牌 / 厂家 TOP5 评测!环保品质 + 技术创新权威榜单发布,匠心赋能家居装饰新体验 - 全局中转站
  • AI元人文构想:从“伦理规范”向“技术合标”的范式扩展
  • containerd base_runtime_spec
  • Luogu P9165 「INOH」Round 1 - 意外
  • 大作业笔记-2
  • xshell 备份配置
  • AshPostgres 政策绕过漏洞:空原子更新操作可能触发副作用
  • [Git] [GitHub] 如何在将本地代码推送到github
  • 2025 最新水泥基渗透结晶型防水涂料厂家 TOP5 评测!技术创新 + 工程实证专业榜单发布,构筑混凝土长效防护屏障 - 全局中转站
  • Supabase 实战指南:从零开始搭建数据库、配置 Auth 并接入 Resend 邮件服务
  • 借助 AI Ping 的 Kimi-K2-Thinking 与 ClaudeCode 的加解密工具开发
  • python: 用os库判断进程是否在运行中?
  • 2025.12.10总结
  • 2025最新AWHFVC防腐厂家TOP5评测!混凝土防腐品牌年度榜单,技术创新+长效防护,守护工业基建安全防线 - 全局中转站
  • 嵌入式原理图设计基础:电源/复位/时钟/IO接口电路全解析
  • Enhance European/American Repairs with OTOFIX D1 Plus 1-Year Update Subscription
  • Yarn vs npm:现代前端包管理器的深度对比
  • CAD技巧
  • 2025 最新玻璃钢防腐厂家 TOP5 评测!技术创新 + 工程实证权威榜单发布,赋能工业设施长效防护生态 - 全局中转站
  • 散修带你入门鸿蒙应用开发基础第六节:变量的作用域与生命周期 - 鸿蒙
  • 2025医疗器械全球法规注册咨询辅导选择评测报告 - 优质品牌商家
  • keil5下载安装教程详细步骤(附安装包)Keil MDK v5.40下载安装详细教程