声明合并与模块扩展有哪些适用边界和工程风险

# 核心结论

声明合并是编译器把同一作用域内允许合并的同名声明组合成统一的类型或符号视图；模块扩展是在已有外部模块声明上补充成员。它们只适合描述运行时确实存在的扩展，例如插件已经给框架实例添加属性，或中间件确实给请求对象附加用户信息。类型声明本身不会创建属性、安装插件或执行初始化，因此不能用声明合并掩盖错误导入、缺失运行时补丁或依赖版本不匹配。

import "example-client";

export {};

declare module "example-client" {
  interface Client {
    traceId: string;
  }
}

这段代码只让编译器认为