Visual Studio 的 /analyze 默认关闭，需在项目属性中手动启用“启用 C++ 代码分析”，且 Debug 配置须额外勾选；它仅在生成时触发、不参与后台分析，依赖准确项目模型（如头文件路径），不检查未加入项目的文件，且与 Clang-Tidy 可共存但需策略区分：前者专注 Windows 安全（如 SAL），后者覆盖跨平台现代 C++ 实践。
Visual Studio 的代码分析不是“开个开关就完事”的功能，它分层、可配置、且不同场景下行为差异很大。直接启用默认设置，大概率会遇到警告爆炸、误报干扰、或根本没生效——关键在选对工具链、配对触发时机、并理解每种分析的边界。
怎么让 /analyze 在 C++ 项目里真正跑起来
MSVC 自带的静态分析（/analyze）常被误认为“编译时自动开启”，其实它默认是关闭的，且和普通编译警告完全隔离。
- 必须手动在项目属性中启用：右键项目 → “属性” → “配置属性” → “常规” → 将“启用 C++ 代码分析”设为“是”
- 它只在
Release配置下默认启用；Debug配置需额外勾选“启用代码分析”（否则即使设了也跳过） -
/analyze会显著拖慢编译速度，尤其大型项目；建议只在 CI 或每日构建中启用，开发时用/W4+/WX控制基础质量 - 它不检查头文件内容（除非该头被显式包含进某个 .cpp），所以把逻辑全塞进头文件会导致漏检
Clang-Tidy 和 Microsoft 分析器能一起用吗
可以，但不能无脑叠加——它们底层机制冲突，强行共存容易互相掩盖问题或重复报错。
Visual Studio Professional 18.8.1
下载
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
- 在 MSBuild 项目中，
enableMicrosoftCodeAnalysis和enableClangTidyCodeAnalysis可同时设为true，但 Clang-Tidy 实际只在成功编译后运行，而 Microsoft 分析器在编译过程中介入 - 若使用
clang-cl工具集，/analyze直接不可用，Clang-Tidy 是唯一选择 - 推荐策略：用 Clang-Tidy 覆盖跨平台风格与现代 C++ 实践（如
modernize-use-auto），用 Microsoft 分析器专注 Windows 平台安全模式（如 SAL 注释验证、__analysis_assume检查） - 禁用某类检查时，别只靠 GUI 勾选；直接在
clangTidyChecks中加前缀-（如-cppcoreguidelines-owning-memory），更可靠
为什么编辑器里看到波浪线，但“错误列表”里没有警告
这是后台分析（Live Analysis）和生成时分析（Build-time Analysis）的典型割裂现象，尤其在 C++ 项目中高频发生。
- 编辑器波浪线来自 Roslyn（C#/VB）或 Clang-Tidy 后台进程，实时响应修改，但不保证与最终构建结果一致
- C++ 的 MSVC
/analyze不参与后台分析，只在点击“生成”后触发；所以改完代码看到波浪线 ≠ 构建时会报错 - 若项目启用了“仅在解决方案打开时启用后台分析”，而你用“添加现有项”方式引入了未加入项目文件的 .cpp，则该文件永远不会被分析，波浪线也不会出现
- 检查是否被排除：右键文件 → “属性” → 确认“代码分析规则集”未设为“
”，且“启用代码分析”为“是”
分析结果里一堆 CA1502 这类编号，怎么定位具体规则
这些是 .NET 代码质量分析器的规则 ID，但 C++ 项目里不会出现——如果你在 C++ 项目中看到它们，说明项目类型或 SDK 配置出错了。
-
CA1502属于 .NET 的Microsoft.CodeAnalysis.Metrics规则集，专用于计算圈复杂度；C++ 项目应看到的是C6001（使用未初始化内存）、C6246（局部变量遮蔽全局）这类 C++ 特有编号 - 真要查规则含义：在“错误列表”中双击该行 → 查看“详细信息”面板里的“规则说明”链接，或直接搜索
CA1502 site:learn.microsoft.com - 想关掉某条规则？不要删警告；在 EditorConfig 文件里写
dotnet_diagnostic.CA1502.severity = none，否则下次 NuGet 包更新可能重置 - 注意阈值配置文件（如
CodeMetricsConfig.txt）只对命令行msbuild /t:Metrics生效，不影响 IDE 实时分析
最易被忽略的一点：所有分析工具都依赖准确的项目模型。如果 CMake 项目没正确解析 compile_commands.json，或 MSBuild 项目里 AdditionalIncludeDirectories 路径写错，分析器连头文件都找不到，自然什么也查不出来——先确保“转到定义”能跳转，再谈分析。
