在Windows执行gradle init时如何生成LF换行符而非CRLF？

算力阿峰

2026-7-31

在Windows上通过gradle init生成LF换行符文件的配置方法

要实现gradle init生成除gradle.cmd外所有文件使用LF换行符，可通过以下几种方式配置：

全局Gradle配置（永久生效）
编辑用户目录下的%USERPROFILE%\.gradle\gradle.properties文件，添加以下配置：
```
org.gradle.jvmargs=-Dline.separator=\n
```
该配置会让所有Gradle项目在生成文本文件时默认使用LF换行符，Windows专属的.cmd脚本仍会保持CRLF（Gradle会自动识别脚本类型适配）。
单次初始化配置（临时生效）
如果不想修改全局配置，可在执行gradle init时直接通过JVM参数指定换行符：
```
gradle init -Dline.separator=\n
```
仅当前初始化的项目会应用LF换行符规则。
Git行为补充配置
由于Windows下Git默认会自动将LF转换为CRLF，即使Gradle生成了LF文件，Git可能会在检出或提交时修改换行符。可在项目根目录创建.gitattributes文件，添加规则锁定换行符：
```
* text=auto eol=lf
*.cmd text eol=crlf
```
这会强制Git对除.cmd外的所有文件使用LF，避免自动转换。
验证结果
生成项目后，用支持显示换行符的编辑器（如VS Code、Notepad++）查看文件属性，确认build.gradle、Git相关文件等已使用LF，仅gradle.cmd保留CRLF。