F2是跨文件语义重命名的正确入口，Ctrl+Shift+L仅用于当前文件内纯文本批量修改；Ctrl+D仅为逐个添加多光标，不执行替换。
F2 是跨文件重命名的正确入口，Ctrl+Shift+L 才是当前文件内批量改字符串的快捷键——别把两者混用，否则要么漏改、要么误伤。
为什么按 Ctrl+D 后只改了几个地方？
Ctrl+D 的作用是“逐个添加相同词的光标”，不是“全部替换”。它默认跳过已修改的位置（因为文本变了，匹配失效），也只在当前文件生效。你按三次 Ctrl+D，可能只选中了前三个 userName，第四个在注释里、第五个在字符串中、第六个拼写不一致（比如 username），它就直接跳过了。
- 想强制全选原始匹配项：先按
Ctrl+U撤回光标，再按Ctrl+Shift+L - 想匹配大小写不敏感或子串：按住
Alt再按Ctrl+D（VSCode 1.86+） - 右下角没显示 “x matches”？说明 VSCode 没识别出完整匹配，双击选中再试
Ctrl+Shift+L 改字符串时容易踩的坑
Ctrl+Shift+L 看似一键全改，但前提是“你选中的确实是你要改的全部语义”。它不区分上下文，data.user.name 和 user.name 会被当成两个不同字符串；UserManager 会把 SuperUserManager 里的子串也圈进来——除非你提前勾选了 Match Case 和 Whole Word。
- 改之前务必用
Ctrl+Shift+F全局预览，确认没漏掉 JSX 标签、Vue 属性、JSON key 这类非代码区域 - 如果目标字符串带点号、括号等特殊字符，先在
Ctrl+H中开启正则，测试\bUserManager\b是否准确匹配 - 改完发现某处异常？很可能是该位置原本是
new UserManager()，但被你替成了new UserAdmin()，而实际应为new UserAdminService()——这种得人工核对
什么时候必须用 F2，而不是 Ctrl+Shift+L？
当你改的是有语义的符号：函数名、类名、导出变量、类型别名。这些改动需要跨文件更新 import、调用点、解构绑定，甚至类型定义。此时 F2 依赖语言服务做 AST 分析，Ctrl+Shift+L 只做纯文本替换，完全不可替代。
-
F2失效常见原因：Plain Text语言模式、缺少jsconfig.json/tsconfig.json、文件在node_modules或dist下 - Go/Rust 需装对应扩展并启用 LSP；Python 依赖 Pylance；纯
.txt或未关联语法的.js文件，F2会退化成仅当前文件的Ctrl+Shift+L - 提示 “Some references were not updated”？说明存在动态访问（如
obj[variableName]）、eval、模板拼接等无法静态分析的情况
批量改文件名和跨文件字符串，不能只靠快捷键
文件系统层面的重命名，VSCode 不提供原生批量支持。F2 在资源管理器里只能单文件重命名；多选后按 F2 是统一改名（所有文件变成同一个名字），不是规则替换。
- 少量文件统一加前缀/后缀：Ctrl/Cmd + 点击多选 → 右键 →
Rename→ 输入新名（同步应用） - 按规则批量改名（如
*.log→*.txt）：装File Utilities插件，右键目录 →Rename Files in Directory，用正则(.*)\.log$→$1.txt - 更灵活控制：打开集成终端，Windows 用 PowerShell：
Get-ChildItem *.log | Rename-Item -NewName {$_.Name -replace '\.log','.txt'}；macOS/Linux 用：for f in *.log; do mv "$f" "${f%.log}.txt"; done
真正难的不是“怎么按快捷键”，而是判断该用哪条路径：符号重命名（F2）、当前文件字符串替换（Ctrl+Shift+L）、全局搜索替换（Ctrl+Shift+H）、还是命令行处理。选错路径，后面全是补救工作。
