<p>函数拦截器实现无侵入AOP日志系统，关键在于编译期重写而非运行时代理，依托C# 12+的[InterceptsLocation]精准绑定源码坐标，通过静态拦截方法注入日志逻辑，并统一封装结构化输出与上下文信息。</p>
函数拦截器实现无侵入 AOP 日志系统，关键在于**不修改业务代码、不引入运行时代理、不依赖反射**，而是借助编译期重写机制，把日志逻辑“静默织入”到目标调用点。C# 12+ 的 [InterceptsLocation] 拦截器正是为此而生——它不是运行时钩子，而是编译器在生成 IL 前就完成的调用替换。
明确拦截位置：精准绑定到源码坐标
拦截器必须指向一个真实存在的方法调用语句，且需精确到文件名、行号和列偏移。这确保了注入行为可追溯、可调试、不模糊。
- 使用
[InterceptsLocation("Program.cs", 15, 8)]明确声明要拦截Program.cs第 15 行第 8 列的调用 - 被拦截的原始方法（如
LogCallSite()）本身可以是空壳或占位符，仅作语法锚点 - 编译器会校验该位置是否确实存在一次方法调用，否则报错，保障类型安全
定义拦截逻辑：静态方法 + 兼容签名
拦截器方法必须是 public static，参数和返回值需与原始调用兼容。它可以执行日志、计时、审计等横切逻辑，并可选择是否继续原逻辑。
- 例如拦截
OrderService.Process()调用，拦截器签名应为public static void ProcessInterceptor(Order order) - 若需记录耗时，可在拦截器中调用
Stopwatch.StartNew()，再通过隐式插入的next()或编译器自动委托执行原方法 - 金融级场景中，还可嵌入风控检查、硬件时间戳审计等强约束逻辑
统一日志封装：避免散落式埋点
把日志格式、上下文（如 TraceId、UserId）、序列化策略等收口到拦截器内部，业务层完全不感知日志存在。
- 拦截器内可读取
[CallerMemberName]、[CallerLineNumber]自动补全调用元信息 - 支持结构化输出（如 JSON 字段），便于 ELK 或 OpenTelemetry 接入
- 通过条件编译符号（如
#if LOG_ENABLED）控制拦截器是否参与编译，实现环境差异化开关
验证与调试：保持透明性与可控性
区别于传统 AOP 框架生成不可见代理类，拦截器织入后的代码仍保留在源生成阶段可见，调试体验接近原生。
- 启用
/source-generators:log编译选项可查看生成的中间代码 - 断点既可打在拦截器方法上，也可打在原始调用行——IDE 会自动映射到实际执行路径
- 若某处调用未被拦截，编译器不会报错，但原始方法照常执行，行为退化安全
