全网最全VS Code多光标格式化配置 | 性能飙升

▌ 技术引导
你绝对想不到，多光标格式化在VS Code中能这么折腾。我见过有人把多光标和格式化规则同时开，结果CPU直接爆表，项目启动卡死。别急着开，先看看怎么配置。在2024年，VS Code多光标格式化功能已经支持了相当复杂的规则，但如果你没按正确方式弄，操作会变得像在泥潭里打滚一样痛苦。我亲测过，用多个光标加上`formatOnType`和`formatOnPaste`可以让代码写得飞快，但也会带来性能问题。所以，我用过`editor.multiCursorModifier`来限制光标数量，用`editor.formatOnPaste`来控制是否自动格式化。别问为什么，这就是我踩过坑之后总结出来的经验。

多光标格式化的核心在于`editor.formatOnType`和`editor.formatOnPaste`这两个设置，但它们不是万能的。如果你用的是TypeScript项目，光标一多，代码格式化就会卡在`tsconfig.json`加载环节。这时候你得在`settings.json`中禁用`formatOnType`，只在`formatOnPaste`上做文章，或者搭配`prettier`来控制。我见过在`prettier`的配置里加上`printWidth: 100`和`tabWidth: 2`，能让多光标格式化时保持一致性，但没设置的话，格式化结果会乱。如果你用的是ESLint，别忘了在`eslint.validate`里加上`vue`、`html`、`javascript`，否则格式化时会报错停顿。

我写过一段代码，其中有两个变量名重复，结果多光标格式化时连变量名都爆掉。这时候你得调整`editor.multiCursorModifier`的值，从`Subword`改成`Click`，这样光标移动更精准。我试过在`vscode`的扩展里用`MultiCursor`插件，效果不错，但性能不如原生。如果你写注释时用多光标，格式化会把注释也一起改，可以用`editor.formatOnSave`和`editor.formatOnType`配合，只在保存时格式化。别以为这能解决所有问题，有些时候你需要手动触发格式化，尤其是处理复杂的格式化规则时。

多光标格式化适合快速修改代码块，比如批量改注释、变量名或者函数参数。但如果你在处理一个大型项目，特别是在多行写入时，格式化可能会拖慢整体速度。我之前在处理一个React项目时，用多光标格式化导致编辑器卡顿，后来发现是`prettier`的`trailingComma`配置没统一，加上`bracketSpacing`和`semi`参数后，性能明显提升。如果你用的是TypeScript，记得在`tsconfig.json`中设置`formatOnType`为`false`，否则写代码时会不断自动格式化，影响体验。

别忘了有些格式化工具不支持多光标，比如某些ESLint配置或者旧版Prettier。这时候你得用`vscode`的`editor.formatOnPaste`加上`prettier`的`insertFinalNewline`参数，或者在`settings.json`里设置`"editor.formatOnPaste": true`，但得控制好光标数量。我见过有人把多光标和格式化规则同时开，结果代码写了一半就卡死了。所以，我建议你分情况处理，比如在处理HTML时用`htmlhint`，在写JS时用`Prettier`，在Vue组件中用`prettier-eslint`。这种分场景配置，才是2024-2026年开发中最稳的方案。

▌ 技术参考
一 在VS Code中配置多光标格式化，首先要理解`editor.formatOnType`和`editor.formatOnPaste`这两个参数。`formatOnType`会在你输入代码时立即格式化，而`formatOnPaste`则会在粘贴代码后进行格式化。两者同时开启可能会导致性能下降，特别是在处理大型文件或复杂代码结构时。我曾在2025年的React项目中，因为同时开了这两项，导致编辑器卡顿到无法操作，于是只能关闭其中一项，选择在粘贴时格式化。

二 要让多光标格式化真正生效，你需要配置`editor.multiCursorModifier`为`Click`。这个设置在2024年之后被默认调整为`Subword`，但如果你不习惯这种自动识别方式，建议手动改回`Click`。这样做能避免光标位置识别错误，尤其是在处理HTML标签或Vue组件时。配置代码是：`"editor.multiCursorModifier": "click"`。如果你不调整，格式化结果可能会在错误的行上生效，导致代码结构混乱。

三 多光标格式化最常见的问题出现在变量名和注释上。我见过不少开发者在写注释时用多光标，结果格式化会把注释也改掉，导致注释格式不一致。解决方法是，在`settings.json`中设置`"editor.formatOnPaste": false`，并单独配置粘贴时的格式化行为。比如，你可以用`vscode`的`format-on-save`插件，或者在`settings.json`中添加`"editor.formatOnSave": true`，这样格式化只会发生在保存时，而不是每次粘贴。

四 在2025年，我注意到Prettier在多光标格式化时会有性能瓶颈。尤其在处理大型TypeScript项目时，格式化会卡在`tsconfig.json`加载阶段。解决方法是，在VS Code中禁用`formatOnType`，只启用`formatOnPaste`，同时在`settings.json`中添加`"editor.defaultFormatter": "esbenp.prettier-vscode"`。这样可以确保格式化工具优先使用Prettier，而不是其他不兼容的工具。如果使用`prettier`的`printWidth: 100`和`tabWidth: 2`，格式化会更稳定。

五 使用多光标格式化时，如果你的代码中有多个相同的代码块，比如多个函数定义或类结构，格式化会自动识别并统一样式。但如果你的代码结构复杂，比如嵌套多个循环，格式化可能会出错。这时候，我建议在`settings.json`中设置`"editor.formatOnSave": false`，并用`prettier`的`semi`参数控制是否添加分号。例如，`"semi": false`可以避免分号冲突。这种配置在2026年依然有效，但需要结合项目实际需求调整。

六 如果你在处理Vue组件，可以考虑使用`prettier-eslint`插件，这样格式化会更精准。配置时，需要在`settings.json`里添加`"eslint.validate": ["vue", "html", "javascript"]`，并确保`prettier`和`eslint`的规则不冲突。我之前在2024年的项目中，因为没有设置`eslint.validate`，导致格式化时报错，进而卡顿。后来加上这个配置，情况好转很多。

七 在多光标格式化过程中，如果你发现某些代码块没有被正确格式化，可能是`prettier`的规则没有覆盖到。这时候可以检查`prettier`的配置文件，添加`"printWidth": 80`和`"tabWidth": 4`，或者在`settings.json`中设置`"editor.formatOnType": false`，避免格式化冲突。2026年，VS Code多光标格式化已经支持`vue`和`html`，但某些旧项目可能需要手动调整格式化工具。

八 多光标格式化特别适合处理注释块，比如批量修改注释内容或统一注释风格。操作方式是：在注释区域按住`Alt`键，然后用鼠标点击多个位置创建光标，再输入内容。不过，此时格式化可能会影响注释结构，所以建议在`settings.json`中关闭`formatOnType`，只保留`formatOnPaste`。我曾用这种方式快速修改一个Vue组件的注释，结果格式化把注释格式全改了，花了整整一小时才恢复。

九 在使用多光标格式化时，如果你的项目中使用了`eslint`和`prettier`，可能会出现格式化冲突。这时候必须在`settings.json`中设置`"eslint.validate": ["vue", "html", "javascript"]`，并确保`prettier`的规则优先级高于`eslint`。我之前在2024年的项目中，因为`eslint`优先级过高，导致格式化失败，最终只能手动调整。后来调整`prettier`的配置，情况好转。

十 多光标格式化在处理JSON文件时表现不佳，尤其是存在多个嵌套层级的文件。我曾处理过一个复杂的配置文件，用多光标格式化导致文件结构错乱，最终只能用`JSON`格式化插件来解决。这时候可以尝试在`settings.json`中设置`"json.format.enable": false`，然后手动格式化，或者用`JSON`格式化插件来替代。2026年的VS Code已经支持部分自动格式化，但JSON处理依然有局限。

十一 在使用多光标格式化时，如果你的代码里存在大量缩进，格式化可能会导致代码对齐错误。这时候建议在`settings.json`中设置`"editor.tabSize": 2`，并关闭`formatOnType`，只保留`formatOnPaste`。我之前在处理一个React项目时，因为没有设置`tabSize`，格式化后代码缩进变得不一致，导致后续开发困难。后来手动调整后，情况才好转。

十二 多光标格式化在处理多行函数参数时特别有用，可以快速对齐参数。操作是：按住`Alt`键，点击多行参数后输入内容，然后触发格式化。但需要注意的是，如果你的项目里使用了`Prettier`，格式化可能会把参数对齐成你不想的样子。这时候可以调整`prettier`的`printWidth`和`tabWidth`参数，或者在`settings.json`中设置`"editor.formatOnSave": false`，避免自动格式化。

十三 2025年，VS Code多光标格式化开始支持`vue`和`html`，但这并不意味着所有项目都能完美适配。我在处理一个Vue项目时，发现`prettier`在格式化`template`部分时会出错，因为`vue`的格式化规则和`prettier`有冲突。最终只能用`prettier-eslint`插件来处理，这样格式化才不会出问题。

十四 如果你的项目中存在多个语言混合使用，比如JavaScript和TypeScript，格式化可能会变慢。我之前在处理一个大型TypeScript项目时，发现多光标格式化卡在加载`tsconfig.json`阶段，这时候可以手动关闭格式化，用`format-on-save`插件来替代。2026年，VS Code的性能优化已经让这种情况有所改善，但仍是需要注意的。

十五 在2024-2026年间，多光标格式化已经成为前端开发的标配，但并不是所有场景都适用。比如在处理大型状态管理库时，多光标格式化可能会引入额外的性能开销。这时候建议用`format-on-save`插件，或者在`settings.json`中设置`"editor.formatOnPaste": true`，这样格式化只在粘贴时触发，不会影响整体性能。多光标格式化适合日常开发，但不建议在首次加载项目时开启，否则会导致编辑器卡顿。