export default与命名导出的差异及无侵入式模块废弃警告实现

首先得明确你遇到的核心问题：ES模块的命名导出是静态解析的，而CommonJS是运行时加载，这直接导致了两种导入方式的行为差异。

为什么import { Foo, Bar }会报错？ #

当你用import { Foo, Bar }时，Webpack这类工具会在编译阶段就去解析模块的导出列表——它会直接读取你代码里的export { ... }声明，而不是等到运行时去读取默认导出对象的属性。你的代码里现在只有export default something，没有静态的export { Foo, Bar }，所以打包工具自然找不到对应的命名导出，抛出错误。

而require('./something')是运行时执行的：它会先跑完模块里的所有代码，拿到导出的something对象，再去解构它的属性——这时候对象上的getter已经生效了，所以能正常拿到Foo和Bar。

无需修改消费端导入的兼容方案 #

要让现有import { Foo, Bar }的写法完全不用改，你得保留静态的命名导出，同时给这些导出添加废弃警告。这里有两种靠谱的实现方式：

1. 用Proxy包装导出的函数（适合函数类型的导出）

如果你的Foo、Bar是函数，用Proxy可以在调用函数时触发警告，非常精准：

// 保存原始的实现
const OriginalFoo = () => 'foo';
const OriginalBar = () => 'bar';

// 包装Foo，调用时触发警告
export const Foo = new Proxy(OriginalFoo, {
  apply(target, thisArg, args) {
    console.warn('⚠️ Foo is deprecated soon, please use the default import instead');
    return Reflect.apply(target, thisArg, args);
  }
});

// 同理包装Bar
export const Bar = new Proxy(OriginalBar, {
  apply(target, thisArg, args) {
    console.warn('⚠️ Bar is deprecated soon, please use the default import instead');
    return Reflect.apply(target, thisArg, args);
  }
});

// 同时保留默认导出，供新代码使用
export default {
  get Foo() {
    console.warn('⚠️ Foo is deprecated soon');
    return OriginalFoo;
  },
  get Bar() {
    console.warn('⚠️ Bar is deprecated soon');
    return OriginalBar;
  }
};

2. 用getter语法定义命名导出（适合非函数类型，比如常量、对象）

如果导出的是普通值或者对象，直接用getter语法就能在访问时触发警告：

const OriginalFoo = 'foo';
const OriginalBar = { value: 'bar' };

export const get Foo() {
  console.warn('⚠️ Foo is deprecated soon');
  return OriginalFoo;
}

export const get Bar() {
  console.warn('⚠️ Bar is deprecated soon');
  return OriginalBar;
}

export default {
  get Foo() {
    console.warn('⚠️ Foo is deprecated soon');
    return OriginalFoo;
  },
  get Bar() {
    console.warn('⚠️ Bar is deprecated soon');
    return OriginalBar;
  }
};

总结 #

• ES模块的静态解析特性决定了：你不能用运行时的对象属性来模拟命名导出，必须显式声明export { Foo, Bar }这类静态导出。
• 上面的方案既能保留原有导入写法的兼容性，又能在用户使用旧导出时触发废弃警告，完美符合你的需求。

内容的提问来源于stack exchange，提问作者Dimitar Christoff