<p>VSCode默认不绑定C#重构快捷键，需手动将editor.action.refactor命令绑定到快捷键（如Ctrl+Shift+R）；必须安装C# Dev Kit、项目含有效.csproj和SDK，且光标置于可重构符号上才能触发重构菜单。</p>
VSCode 默认不绑定重构快捷键，必须手动配置 editor.action.refactor 命令才能触发重命名、提取方法等操作——否则只能靠鼠标点灯泡图标，效率直接打五折。
怎么给 C# 重构配快捷键
VSCode 的重构功能依赖 OmniSharp（通过 C# Dev Kit 或 vscode-csharp 扩展提供），但默认没快捷键。得自己加：
- 按
Ctrl+K Ctrl+S打开快捷键设置，搜refactor - 找到命令
editor.action.refactor，双击它，按你想用的组合键（比如Ctrl+Shift+R） - 确认后，光标停在可重构位置（如变量名、方法名上），按下快捷键就能弹出菜单
- 如果没反应，检查是否已安装 C# Dev Kit，且项目有
.csproj和有效 SDK 引用
重命名符号时容易踩的坑
VSCode 的重命名（F2 或快捷键调出 refactor → “Rename Symbol”）看起来简单，但实际常卡在几个地方：
- 光标必须严格落在符号标识符内部（比如
userName的任意字母上），落在空格或点号后无效 - 若项目含多个同名类型（如分部类
partial class Person分散在不同文件），重命名会失败并提示“无法解析唯一定义” - 默认不更新字符串字面量和注释里的旧名，得手动勾选“Also rename in comments and strings”（弹窗里那个小复选框）
- 跨项目引用时，仅当前工作区内的引用被更新；其他项目需单独打开并重命名，否则编译报错
The type or namespace name 'OldName' could not be found
为什么 Ctrl+D 不适合重命名 C# 变量
Ctrl+D 是通用多选，对 C# 重命名几乎没用，原因很实在：
- 它只匹配完全相同的文本，而 C# 中同一变量可能以
this.name、_name、Name（属性）、name（参数）等形式出现，Ctrl+D无法识别语义关联 - 选中后手动改名，不会自动更新引用，极易漏改导致运行时
NullReferenceException或编译失败 - 没有作用域限制——它可能把 JSON 字符串里、注释里、甚至 SQL 片段里的同名文本一起选中，改完反而破坏数据
- 真正安全的重命名必须走
editor.action.rename（通常绑定到F2）或editor.action.refactor菜单里的 “Rename Symbol”，由 OmniSharp 解析 AST 后精准定位所有引用
同步类型名与文件名的限制
C# 类型名和文件名不一致是常见维护隐患，VSCode + OmniSharp 支持一键同步，但有几个硬性约束：
- 仅支持单类型文件：如果
Person.cs里定义了class Person和class Address，该重构不可用 - .NET Standard / .NET Core / .NET 5+ 项目不支持此操作（Visual Studio 里叫 “Sync type and filename”，VSCode 当前未实现）
- 文件名含特殊字符（如
My-Service.cs）时，类型名不能含连字符（C# 标识符不允许），同步会失败 - 若目标文件已存在（比如想把
UserService.cs里的class User同步为User.cs，但User.cs已存在），操作会被拒绝，不会覆盖或合并
最麻烦的其实是分部类——它天然跨文件，重命名时 OmniSharp 无法确定哪个文件该改名，也没法自动同步所有片段。这种时候，要么手动改，要么先合并再重构，没捷径。
