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

Git在特定分支上强制关闭CRLF换行符转换的配置

秋涛姑娘_5171

秋涛姑娘_5171

发布时间:2026-10-17 07:35:22

|

740人浏览过

|

来源于php中文网

原创

core.autocrlf不支持按分支设置,其作用范围为全局或仓库级;所谓“某分支生效”实为.gitattributes文件在该分支中存在并被Git自动应用所致,因.gitattributes优先级高于core.autocrlf,可按路径精确控制换行符行为。

git在特定分支上强制关闭crlf换行符转换的配置

为什么 core.autocrlf 在特定分支上不起作用

Git 的换行符配置是全局或仓库级的,core.autocrlf 本身不支持“按分支设置”。你看到的“某分支生效”现象,通常是工作区文件状态、检出历史或 .gitattributes 文件介入导致的错觉。真正能按路径(包括分支所含文件)控制 CRLF 行为的,只有 .gitattributes —— 它在检出和提交时由 Git 自动读取并应用。

用 .gitattributes 精确控制某分支的换行符行为

假设你想让 dev 分支下的所有 .py 文件禁用 CRLF 转换(即始终以 LF 存储和检出),关键不是改分支配置,而是确保该分支中存在并正确应用 .gitattributes:

  • 在 dev 分支根目录下创建或编辑 .gitattributes
  • 写入:
    * text=auto eol=lf
    (对所有文本文件统一用 LF)
  • 或更精准:
    *.py text eol=lf
    (只约束 Python 文件)
  • 必须用 git add .gitattributes 提交,否则其他分支检出时不会生效
  • 已检出的文件需重新刷新:运行 git rm --cached -r . && git reset --hard(⚠️会丢弃工作区未提交更改)

core.autocrlf 和 .gitattributes 冲突时谁赢

当两者同时存在,.gitattributes 优先级更高。例如:

One-click installation of GitHub projects
One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目:规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载
  • 本地设了 git config core.autocrlf true(Windows 默认)
  • 但项目根目录有 .gitattributes 含 *.sh eol=lf
  • 那么所有 .sh 文件都会忽略 core.autocrlf,强制以 LF 检出
  • 没被 .gitattributes 明确匹配的文件,才退回到 core.autocrlf 规则

所以“强制关闭 CRLF”本质是:删掉或覆盖 core.autocrlf 的影响,靠 .gitattributes 做最终裁定。

容易被忽略的三个硬性前提

即使写了正确的 .gitattributes,以下任一条件不满足,CRLF 还是会偷偷出现:

  • .gitattributes 文件本身必须用 LF 换行(用 Notepad++ 或 VS Code 确认编码为 UTF-8 + LF,否则 Git 解析失败)
  • 文件必须是 Git 跟踪状态(git status 显示为 modified 或 up to date,而非 untracked)
  • 修改后重新检出前,要清空 Git 缓存:仅改 .gitattributes 不够,得 git add -u && git commit,再 git checkout 切回该分支触发重应用

分支切换本身不会自动重写工作区换行符;只有 Git 重新检出文件时,才会依据当前分支里的 .gitattributes 执行转换。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

火山引擎

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

豆包大模型

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

DeepSeek

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

WorkBuddy

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

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

6299

2023.07.05

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

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

1820

2023.07.06

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

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

1074

2023.07.24

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

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

4097

2024.04.09

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

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

3841

2024.04.09

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

20

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

0

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

20

2026.10.16

热门下载

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

精品课程

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

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

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

共8课时 | 1.9万人学习

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

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