VS Code Linux Devcontainer在Windows环境下自动将LF行尾转为CRLF的原因及解决方案咨询

首先咱们拆解下你遇到的问题：WSL本地文件明明是LF，但Devcontainer里的VS Code却显示成CRLF，本地查看文件格式又正常——这本质上是VS Code在容器环境中的行尾序列配置，以及跨环境文件挂载的转换逻辑导致的，文件本身并没有被修改，只是编辑器的识别/处理方式变了。

为什么Devcontainer会显示CRLF？ #

主要有这几个核心原因：

• VS Code配置继承：当你从Windows端通过Remote-Containers打开Devcontainer时，VS Code可能默认继承了Windows本地的files.eol（行尾序列）或files.autocrlf设置。Windows系统默认行尾是CRLF，容器内的VS Code会据此把LF文件识别/显示为CRLF，甚至触发自动转换。
• 跨环境文件挂载的转换逻辑：Devcontainer是把WSL的目录挂载到容器内的，虽然WSL里文件是LF，但VS Code的Remote扩展在处理跨环境文件时，可能触发了行尾自动转换，尤其是如果Windows端VS Code开启了files.autocrlf: true的话。
• 工作区配置覆盖：如果项目的.vscode/settings.json里配置了files.eol为\r\n，容器内的VS Code会读取这个配置，从而显示CRLF。

格式设置的定义来源 #

这些行尾格式设置的优先级从高到低是：

1. 项目工作区设置：.vscode/settings.json里的files.eol或files.autocrlf配置
2. Devcontainer专属配置：devcontainer.json中通过settings字段指定的VS Code配置
3. VS Code用户全局设置：Windows端或WSL端的用户级settings.json
4. Git全局/项目配置：git config里的core.autocrlf或.gitattributes文件（你WSL里文件是LF，所以这部分大概率没问题，除非容器内的Git配置单独修改过）

解决方法：强制使用LF行尾格式 #

这里有几个靠谱的方案，按推荐优先级排序：

1. 在Devcontainer配置中强制指定LF #

直接在你的devcontainer.json里添加VS Code设置，让容器内的编辑器强制使用LF，无视Windows端的默认配置：

"settings": {
    "files.eol": "\n",
    "files.autocrlf": false
}

每次启动Devcontainer时，VS Code都会自动应用这个配置，从容器层面锁定行尾格式。

2. 用.gitattributes从根源锁定项目行尾 #

在项目根目录创建.gitattributes文件，指定所有文件（或特定类型文件）使用LF，避免任何环境下的自动转换：

* text=auto eol=lf
# 如果你有二进制文件，可以单独排除，比如：
*.png binary
*.jpg binary

这个文件会告诉Git和VS Code，不管在什么系统下，都保持LF行尾，彻底避免格式混乱。

3. 检查并调整VS Code全局/工作区设置 #

• 打开Windows端VS Code的设置，搜索files.eol，如果全局设置是\r\n，可以改成\n（不过这个会影响你其他Windows项目，所以更推荐前面两个方案）。
• 如果项目的.vscode/settings.json里有files.eol设为\r\n，直接修改成\n或者删掉该配置。

4. 验证容器内的Git配置 #

进入Devcontainer的终端，检查Git的autocrlf设置：

git config --global core.autocrlf

如果输出是true或input，改成false：

git config --global core.autocrlf false

这个操作只影响容器内的Git操作，配合前面的VS Code设置一起用效果更好。

总结 #

核心思路就是在Devcontainer层面强制LF配置，再加上.gitattributes锁定项目行尾格式，这样不管是Windows、WSL还是Devcontainer环境，文件都会保持LF格式，VS Code也不会再显示错误的行尾类型。

内容的提问来源于stack exchange，提问作者moudi