Visual Studio代码重构需精准定位光标位置并正确触发Ctrl+.菜单：停在方法名可改签名或提取接口，停在参数名可加null检查，选中代码才能提取方法或本地函数；提取方法生成可复用的独立方法，提取本地函数仅限当前方法内使用且不支持向外return；更改签名会自动更新调用但不加命名参数，新增参数需手动调整或使用TODO占位；删除未使用引用仅适用于SDK样式项目且需提前启用选项，不处理反射加载的包。
Visual Studio 的代码重构不是“学完就能用”，而是得在具体操作中对准位置、按对快捷键、看懂预览窗口——否则容易改错地方或漏掉调用点。
Ctrl + . 是核心入口，但光标位置决定能做什么
几乎所有重构都从 Ctrl + . 触发，但菜单内容完全取决于光标停在哪：
- 停在方法名上 → 出现「更改签名」「提取接口」「拉取成员」等选项
- 停在某个参数名上 → 可选「为所有参数添加 null 检查」，但仅对可空引用类型生效
- 选中一段表达式 → 才能触发「提取本地函数」或「提取方法」
- 停在
using语句区域 → 才有「对 using 排序」或「删除未使用的 using」
常见错误是光标放在方法体内部却想改签名，结果菜单里根本没「更改签名」——必须移到方法名或任意一处调用上。
提取方法和提取本地函数容易混淆
两者都从选中代码开始，但用途和作用域完全不同：
Visual Studio Professional 18.8.1
下载
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
-
提取方法：生成一个独立的 public 或 private 方法，可在整个类甚至其他类中复用；适合逻辑通用、可能被多次调用的代码块 -
提取本地函数：只在当前方法内可见，不能带访问修饰符，也不能被外部调用；适合封装重复的条件判断或小段计算，且依赖当前方法的局部变量
如果提取后发现新函数用了 return 却报错，大概率是误用了「提取本地函数」——它不支持从嵌套作用域向外返回，此时应换用「提取方法」。
更改方法签名会自动更新所有调用，但默认不加命名参数
用 Ctrl + R, Ctrl + V 或 Ctrl + . →「更改签名」后，新增/删除/重排参数时：
- 所有已有调用会被强制重写，但不会自动转成命名参数（
MyMethod(param1: x, param2: y)） - 如果原调用是位置传参（
MyMethod(x, y)），新增参数在中间会导致编译失败，必须手动调整顺序或补值 - 勾选「预览引用更改」再点确定，能提前看到所有要改的地方；不勾选就直接提交，风险很高
- 新增参数时选「使用 TODO 变量」，会在每个调用处插入
/* TODO */占位，方便逐个确认传什么
删除未使用的引用只对 SDK 样式项目有效
右键项目 →「删除未使用的引用」看似通用，实际有硬性限制：
- 仅适用于
<project sdk="Microsoft.NET.Sdk"></project>这类新格式项目；传统.csproj（含<targetframeworkversion></targetframeworkversion>）不支持 - 即使项目是 SDK 样式，也得先在
Tools → Options → Text Editor → C# → Advanced中启用「显示“删除未使用的引用”命令」 - 它只删 NuGet 包和项目引用，不删
using语句；删 using 得用「对 using 排序」或「删除未使用的 using」 - 如果某 NuGet 包是通过运行时插件或反射加载的（比如 Serilog 自动注册），它会被误判为“未使用”而删掉
重构不是一劳永逸的清理工具，尤其是涉及引用和签名变更时，IDE 的自动推断有边界。真正安全的做法，是每次只做一项变更、开预览、扫一眼关键调用点，再按 Enter 确认。
