C#：pdb

C#中的 .pdb（Program Database）文件是程序数据库文件，用于存储调试符号信息，是连接编译后的二进制代码（.exe/.dll）与源代码的关键桥梁 。

1、作用
- 启用调试：允许调试器（如 Visual Studio）设置断点、单步执行、查看局部变量和调用堆栈。
- 映射关系：记录源代码行号、函数名、变量名与机器码地址的对应关系，无此文件则只能看到反汇编代码或模糊的错误堆栈。
- 发布诊断：在生产环境中，PDB 可用于解析异常堆栈跟踪（Stack Trace），定位具体出错代码行，但通常不包含可执行逻辑，不影响程序运行性能 。

2、生成与控制
- 默认行为：在 `Debug` 配置下，编译器自动在同目录生成与输出文件同名的 `.pdb` 文件；`Release` 配置默认不生成（除非显式开启）。
- 编译器选项：
  - `/debug:full`：生成完整调试信息，代码可调试（推荐开发用）。
  - `/debug:pdbonly`：仅生成 PDB，代码不可调试（适合需保留符号但不希望被附加调试的发布版）。
  - `/pdb:filename`：自定义 PDB 文件名或路径（较少在 IDE 中使用，多用于命令行编译）。
- 项目设置：在 `.csproj` 中通过 `<DebugType>` 控制：
  - `portable`：生成跨平台兼容的便携式 PDB（现代 .NET 推荐）。
  - `full` / `pdbonly`：传统 Windows PDB 格式。

3、使用注意事项
- 必须匹配：PDB 必须与对应的 .exe/.dll 严格版本一致（GUID 和时间戳匹配），否则调试器会拒绝加载。
- 部署建议：生产环境部署时，可将 PDB 单独存储于符号服务器（Symbol Server）或本地归档，不建议直接随应用发布以防泄露内部逻辑细节，除非需要现场故障排查。
- 安全提示：PDB 可能包含源代码路径、变量名等敏感信息，敏感项目需评估是否脱敏或加密存储 。

若需查看 PDB 内容，可使用工具如 [dotnet-dump](https://learn.microsoft.com/dotnet/core/diagnostics/dotnet-dump) 或 Visual Studio 的“模块”窗口加载符号信息进行验证。