ctrl + . 是 visual studio 安全重构的起点，基于 roslyn 语义分析，支持重命名、提取方法、更改签名等操作，需通过预览确认范围，避免漏改字符串、反射或配置中的引用。

Ctrl + . 是 Visual Studio 里安全重构的起点，不是“试试看”，而是有明确边界和回退路径的操作。所有重构都基于语义分析，只要代码能通过编译、没有语法错误，绝大多数重构就是安全的——但前提是别跳过预览。

用 Ctrl + . 触发重构，而不是手动改名或剪切粘贴

手动重命名变量或方法，极易漏掉注释、字符串字面量、反射调用里的硬编码名称，甚至 XAML 或 JSON 配置中的引用。Ctrl + . 调出的“快速操作和重构”菜单，背后是 Roslyn 编译器的符号解析，它知道哪些是真实引用、哪些只是文本匹配。

• 光标放在要重构的符号上（比如一个方法名），按 Ctrl + .，选“重命名”——IDE 会自动扫描整个解决方案，包括跨项目引用
• 勾选“更新字符串中的引用”复选框（如果需要），但注意：这会匹配所有相同文本，慎用于含歧义的短名（如 id、data）
• 务必点开“预览更改”窗口，确认修改范围；尤其当项目含生成代码（如 gRPC stubs、EF Core migrations）时，有些文件可能被排除在重命名之外

提取方法前先确认作用域和副作用

Extract Method 看似简单，但容易把带状态变更的代码块抽成纯函数，导致逻辑断裂。比如一段含 list.Add(...) 和 counter++ 的代码，直接提取后，调用方可能误以为它是无副作用的。

Visual Studio Professional 18.8.1

Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。

下载

• 突出显示代码后按 Ctrl + . → “提取方法”，IDE 会自动推导参数和返回值，但不会自动判断是否该传入 ref 或 out
• 如果被提取代码访问了局部变量，IDE 默认将其作为参数传入；若该变量后续还被使用，需检查逻辑是否仍连贯
• 避免提取含 return、throw 或 await 的不完整控制流片段——这类提取常导致编译错误或行为偏移

改方法签名时警惕调用方的隐式依赖

Change Signature 能自动更新所有调用点，但无法识别“约定式依赖”：比如某个方法本应只接收非空字符串，但调用方靠文档或经验保证，没做空检查。你加了 string? 参数并设默认值，反而掩盖了潜在问题。

• 在“更改签名”对话框中，新增参数时优先选“可选参数 + 默认值”，而非强制所有调用点立即填值；给默认值用 TODO 占位，比随意填 null 或空字符串更安全
• 删除参数前，先全局搜索该参数名在调用处的注释（如 // pass null for legacy mode），确认其语义是否真可弃
• 对 public API 方法，改签名等于破坏二进制兼容性；SDK 样式项目中，建议配合 [Obsolete] 属性过渡，而非直接删

删未用代码前验证“真没用”，而非“看起来没用”

Delete unused code 和 Remove unused references 很诱人，但它们依赖静态分析——而反射、动态加载、插件机制、测试桩、甚至某些 DI 容器注册，都会让代码“看似未用”。

• “删除无法访问的代码”只删 throw 后的死代码（如示例中 Console.WriteLine），不碰条件分支里“理论上不可达”但实际可能被调试开关激活的逻辑
• “删除未使用的引用”仅适用于 SDK 样式项目；传统 .csproj 不支持，强行操作可能破坏构建
• 删 NuGet 引用前，检查 AssemblyLoadContext.Default.Load()、Type.GetType("...") 或 AppDomain.CurrentDomain.GetAssemblies() 是否间接依赖它

重构不是越“干净”越好，而是让代码意图更清晰、变更更可控。Visual Studio 的重构能力很强，但它的安全边界止于编译器可见的符号——那些藏在字符串、配置、运行时加载里的耦合，得靠人来审。