静态构造函数在类型首次被主动引用时执行且仅一次，触发场景包括访问静态成员、创建首个实例或反射触及类型元数据；typeof、数组长度获取及未赋值声明均不触发。

SwaggerUI方法无说明需用///和添加XML注释，启用GenerateDocumentationFile并调用IncludeXmlComments；请求体示例推荐实现IExamplesProvider接口；响应示例须用ProducesResponseType(typeof(T))显式指定类型。

直接用HttpClient手动拼OAuth2.0请求容易失败，因其涉及重定向、state校验、强制PKCE（尤其桌面端）、token刷新及scope控制，手动易漏state、误用response_type、忽略code_verifier或redirect_uri不匹配等。

Dispatcher.Invoke同步阻塞后台线程直至UI线程执行完委托，适用于需返回值或确保UI操作完成的场景；Dispatcher.BeginInvoke异步提交委托且不等待，但无法直接获取返回值，.NET6+中已过时，推荐使用InvokeAsync。

refreadonly方法返回一个只读引用，调用方能读取但不能通过该引用修改原值；它适用于高性能结构体访问以避免复制开销，声明时需显式使用refreadonly修饰符，且返回表达式必须支持只读引用。

ConditionalWeakTable是.NET中线程安全、弱引用的键值映射结构，专用于为对象临时附加数据且不阻止其被GC回收，适用于AOP、序列化上下文、调试信息挂载等场景。