VSCode光标“跳走”实为格式化重排导致位置映射失效，根本解法是禁用formatOnSave/formatOnPaste、改用范围格式化（Ctrl+K Ctrl+F）、统一格式化器规则并检查工作区设置覆盖。
VSCode 保存或格式化时光标“跳走”，不是光标被移动了，而是代码结构被重排后，原字符位置对应的行号/列号变了，编辑器只能把光标锚定在旧偏移量上——看起来像跳，其实是同步失效。根本解法不是锁光标，而是让格式化不触发重排，或让重排更温和。
关掉 formatOnSave 和 formatOnPaste 是最直接验证手段
临时禁用这两项，能立刻确认是否由自动格式化导致光标错位：
"editor.formatOnSave": false"editor.formatOnPaste": false
改完保存一次，再手动按 Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）触发一次格式化。如果此时光标仍跳，说明问题出在语言服务、折叠逻辑或扩展监听器（如 onWillSaveTextDocument），而非 VS Code 自身格式化链路。
格式化器本身决定光标是否“稳定”
Prettier、ESLint、clang-format 这些工具在重排时会主动调整换行、缩进、括号位置——只要它们的规则和你当前编辑节奏冲突（比如把单行 JSX 属性全拆成多行），光标必然失焦。关键参数有：
-
printWidth（Prettier）或ColumnLimit（Clang-Format）设得过小，会强制折行 → 光标从第 1 行第 50 列跳到第 3 行第 8 列 -
endOfLine: "lf"和files.preferredLineEnding: "lf"不一致，保存时换行符被重写，整段行号偏移 -
javascript.format.insertSpaceBeforeFunctionParenthesis: true这类微调项虽不改结构，但插入空格后，光标列号也会变
这类行为无法靠 VS Code 设置拦截，必须改格式化器配置，或换用更保守的规则集（例如 Prettier 的 proseWrap: "preserve"）。
选中后格式化比整文件更可控，但依赖 formatRange 协议
想只动几行又不让光标乱跑，优先用范围格式化：
- 先按
Ctrl+L（Win/Linux）或Cmd+L（macOS）选中当前行 - 再按
Ctrl+K Ctrl+F（Win/Linux）或Cmd+K Cmd+F（macOS）→ 这是editor.action.formatSelection命令，直连格式化器的formatRange接口 - 它只处理语法上完整的节点（如一个函数、一个对象字面量），不会跨语句切开，重排幅度小，光标偏移概率低
注意：Shift+Alt+F 在选中状态下**不一定**降级为范围格式化——很多插件只实现了 formatDocument，没实现 formatRange，此时它仍会格式化全文。用 Ctrl+K Ctrl+F 才是真正可靠的选区入口。
工作区设置覆盖用户设置是静默坑点
你以为关掉了 editor.formatOnSave，但它可能在项目根目录的 .vscode/settings.json 里又被设回 true，或者某条 "[typescript]" 语言专属配置覆盖了全局设置。VS Code 永远以工作区设置为最高优先级。
排查方法：按 Ctrl+Shift+P → 输入 Preferences: Open Workspace Settings (JSON)，直接看当前生效的完整配置。别信图形界面右上角的“在 settings.json 中设置”小图标，它有时只显示用户级路径。
格式化与光标的关系，本质是“文本变更量”与“光标锚定机制”的博弈。越少动结构，光标越稳；越依赖外部工具链，越难绕过重排。没有银弹，只有分层控制：禁用自动触发 → 缩小作用域 → 对齐格式化器规则 → 锁定配置作用域。
