直接改旧项目代码关键在于精准重构而非手动替换；visual studio 的 ctrl + . 能语义识别并安全重命名标识符，同步更新合法引用及文件名，避免漏改导致崩溃。
用 Ctrl + . 触发重构，别手敲重命名
手动查找替换 OldClass → NewClass 极易漏掉注释、字符串、资源 ID 或反射调用里的引用，导致运行时崩溃。Ctrl + .（快速操作）能识别符号语义，只改真正属于该标识符的引用。
- 光标停在类名/方法名上，按
Ctrl + .，选“重命名”，输入新名后所有合法引用自动更新 - 如果类型名和文件名不一致，IDE 会额外提示“是否同步文件名”，勾选后连文件也一起重命名
- 对分部类（
partial class）或含extern alias的场景，它会跳过模糊匹配，避免误改
用 /permissive- 暴露隐性非标用法
很多旧 C++ 项目能编译，只是因为 MSVC 过去太宽容。启用 /permissive- 后，for (int i; i 中未初始化的 <code>i、依赖 ADL 的非法 using namespace std; 等都会标红。
Visual Studio Professional 18.8.1
下载
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
- 在项目属性 → C/C++ → 语言 → “符合性模式”中设为“是”（即启用
/permissive-） - 错误列表里出现的
C2365、C2760类错误，基本都指向非标准语法，点进去就能定位到具体行 - 不要一次性全开：先对单个 .cpp 文件启用，修复后再扩展，避免被几百个错误淹没
用“提取方法”拆解超长函数，别硬读逻辑
老项目里动辄 300 行的 OnPaint 或 ProcessMessage 函数，靠人眼理清执行路径效率极低。Visual Studio 的“提取方法”不是简单剪切粘贴，它会自动推导参数、处理作用域、保留局部状态。
- 选中一段有明确意图的代码块（比如“计算窗口缩放比例”或“序列化用户配置”），按
Ctrl + .→ “提取方法” - IDE 会列出所有需传入的变量，并标记哪些可转为
const，哪些必须按引用传 - 生成的方法默认带 XML 注释占位符，顺手补一句说明，比写 10 行注释更省力
删未用代码前，先确认它真没被调用
“删除无法访问的代码”和“删除未使用的引用”这两项重构看似安全，但在旧项目里常踩坑：宏展开、条件编译（#ifdef _DEBUG）、COM 接口 QueryInterface 动态调用，都可能让 IDE 误判为“死代码”。
- 执行“删除无法访问的代码”前，先全局搜索该代码块内关键变量名，看是否出现在
#define或字符串拼接中 - 删 NuGet 引用时，检查
packages.config或.csproj里是否有<packagereference include="..." condition=" '$(Configuration)' == 'Debug' "></packagereference>这类条件引用 - 对 Win32 API 调用（如
SendMessage带自定义消息码），即使没显式调用，也不能轻信“未使用”提示
UpgradeLog.htm 里“行为更改”和“API 弃用”章节，比盲目改代码管用得多。
