用途:通过 Portable PDB 与 SourceLink 数据获取和校验 .NET 程序集的源码映射,定位类型与成员对应的文件、行号和 URL,或在本地解析与 PDB 校验和匹配的源码内容。
主要能力:-S "Source Files" 映射类型作用域内的类型;库与包作用域使用 SourceLink: Files;-S "Source Locations" 给出每个成员的文件与行 URL 而不抓取正文;--urls 输出干净的 URL 列表,--paths 输出源码路径行。使用 --repo 时,会针对 PDB 校验和验证本地文件与 GitHub 已提交 blob。网络 PDB Source 抓取遵循主机传输允许的重定向,仅在返回体与校验和匹配时返回,不把最终目的地视为源码来源。可用 library -S "SourceLink: Integrity" 做可选校验,确认每个可抓取的非内嵌编译器源文档在重定向后仍保持归属的仓库与版本。若本地或 SourceLink 均无可用 PDB 或校验和匹配源码,则改用始终本地的反编译技能。
获取 PDB 源码:-S "PDB Source" 返回由 Portable PDB 坐标选定的源码正文,经本地或 SourceLink 获取并按 PDB 校验和验证。用 --print 抓取某个可打印 SourceLink 行对应的源码正文;多行时用 --row N|first|last 选择显示行,该行无可打印文档时会直接报告而不静默换行。--repo 需提供完全限定的克隆路径,且仅适用于 raw.githubusercontent.com 的 SourceLink URL。
成员部件:--source-parts 获取并校验源码后,从 PDB 跨度中单独发现词法部件;部件名有 member、xml-docs、attributes、signature、body,不可用部件会失败而非替换。
URL 形式:PDB 携带 SourceLink 数据而非 SourceLink 本身。URL 行默认使用 raw/可抓取形式,--prefer-rendered-urls 在支持时优先浏览器视图。--raw 为未修饰的所选载荷出口。
限制:校验和仅证明返回字节与 PDB 声明一致,并不独立证明这些字节是产生某 MethodDef 的物理语法树;PDB Source 名称已明确该证据边界。词法范围不增强 PDB/校验和来源断言。包或 PDB 获取仍可能使用网络。