VSCode 保存时自动删除行尾空格：一个原生设置就够了
想告别代码行尾那些恼人的空格吗？其实，VSCode 内置的 files.trimTrailingWhitespace 设置就能完美解决，根本不需要额外安装插件，也无需依赖 Prettier 或 ESLint 等格式化工具。
这个功能的设计非常直接：它只在你手动保存文件（比如按下 Ctrl+S 或 Cmd+S）的那一刻触发，默默清理掉每一行末尾的空格和制表符。至于编辑器的自动保存功能，除非你设置了 files.autoSa ve: "onFocusChange" 并且确实切换了编辑器焦点，否则它通常不会介入。
如何确认并开启 files.trimTrailingWhitespace
这个选项默认是关闭的，需要手动开启。操作路径很简单：
- 打开 VSCode 设置界面（快捷键
Ctrl+,或Cmd+,），搜索 “trim trailing whitespace”，找到并勾选对应选项。 - 或者，直接编辑
settings.json文件，添加一行："files.trimTrailingWhitespace": true。
这里有个最佳实践建议：将这个配置写入项目根目录的 .vscode/settings.json 文件。 这样做有两个好处：一是避免污染你的全局用户设置，二是能确保团队所有成员使用统一的代码规范，减少因环境差异导致的意外空格提交。
修改完成后无需重启 VSCode，设置会立刻生效。当然，你得保存一下文件，才能亲眼看到行尾空格被“唰”地一下清理干净的效果。
为什么开启了却没效果？排查常见失效原因
如果你发现设置明明开了，但空格依然健在，问题通常不在于配置写错，而是被其他优先级更高的规则给“拦截”或“覆盖”了。可以顺着下面几条线索排查：
- 项目级设置覆盖：检查项目内的
.vscode/settings.json，是否显式地写了"files.trimTrailingWhitespace": false。项目级设置的优先级高于用户级设置。 - 语言专属配置：VSCode 允许为特定语言设置不同规则。例如，可能在
settings.json里有这么一段："[shellscript]": {"files.trimTrailingWhitespace": false}，这会导致 Shell 脚本文件不受全局规则影响。 - EditorConfig 插件干扰：如果项目使用了 EditorConfig 并安装了对应插件，且根目录的
.editorconfig文件中设置了trim_trailing_whitespace = false，那么它会覆盖 VSCode 的原生设置。 - 文件状态异常：文件处于只读状态（例如被 Git LFS 锁定、或权限不足）时，VSCode 不会对其执行修剪操作。
- 文件被排除：文件路径如果被
files.exclude或search.exclude规则匹配并隐藏，VSCode 也可能跳过处理。
分清 files.trimTrailingWhitespace 与格式化工具
这一点至关重要：files.trimTrailingWhitespace 和通过 editor.formatOnSa ve 触发的格式化（如 Prettier、ESLint）是两套完全独立的机制。
前者是 VSCode 内核级别的纯文本操作，只做一件事——毫秒级扫描并删除每行末尾的空白字符，简单高效，没有副作用。后者则是调用外部的格式化工具，会重新调整代码结构、修改缩进、移动括号位置，功能复杂得多。
如果两者同时开启，可能会带来一些不必要的麻烦：
- 重复操作：假设 Prettier 的某条规则也处理了行尾空格，那么同一个空格可能被删两次。虽然不会报错，但确实浪费了性能。
- 潜在冲突：更复杂的情况是规则冲突。例如，ESLint 的
no-trailing-spaces规则如果被eslint-config-prettier禁用，可能导致格式化后空格依然存在，而此时 VSCode 的原生功能又在保存时默默清理，行为变得不一致。
因此，最稳妥的方案是：全局开启 files.trimTrailingWhitespace: true，让它专心负责清理行尾空格；然后将 Prettier 等格式化工具的配置调整为只负责代码结构排版，避免在空格处理上产生重叠或冲突。
关于空行与文件末尾的处理
这里有个常见的误解需要澄清：files.trimTrailingWhitespace 会处理所有行，包括纯空行。它会将空行末尾可能存在的空格或制表符删除，但不会删除空行本身（即不会移除换行符）。
如果你有进一步的需求，需要配合其他设置：
- 删除文件末尾多余空行：需要开启另一个设置：
"files.trimFinalNewlines": true。它会把文件末尾连续的多个换行符清理到只剩一个。 - 确保文件以换行符结尾：这是许多工具（如 Git）推荐的做法，可以开启
"files.insertFinalNewline": true。 - 批量删除所有空行：如果目标不只是文件末尾，而是全文所有的空行，那就需要借助查找替换功能了。可以使用正则表达式
^\s*$\n进行查找并替换为空。注意，查找内容必须包含\n（换行符），否则只会清空空行的内容，而空行的“位置”还在。
最后，如果你在 Git 提交前，依然在 diff 中看到行尾空格的改动，那很可能不是 VSCode 的锅。这时候应该去检查项目的 .gitattributes 文件或者 Git 的全局配置 core.whitespace，可能是 Git 自身的空白字符处理逻辑在起作用。问题源头，往往在编辑器之外。
