Esbuild打包含默认值可选参数的接口函数时报错，求解决方法

问题根源 #

TypeScript允许在接口的函数类型定义中添加参数默认值，但这属于TypeScript专属的语法特性。esbuild使用自研的TypeScript解析器（而非官方tsc），对这类语法的支持存在限制，会将接口里的参数默认值误判为JavaScript语法错误，从而抛出Unexpected "="。

另外从设计逻辑来看，接口的核心作用是定义类型契约，参数默认值属于函数的实现细节，本就不应该写在接口定义中——tsc允许这种写法只是语法兼容，但并非最佳实践。

解决方案 #

方案1：将默认值移到函数实现中（推荐） #

修改接口，移除参数默认值，只保留类型定义：

interface DataProvider {
    getEntities: ({ foo, skip, bar }: { foo: any; skip?: number; bar?: any; }) => Promise<GetEntitiesResult>;
}

然后在实现该接口的函数里添加默认值：

const dataProvider: DataProvider = {
    getEntities: ({ foo, skip = 0, bar }) => {
        // 业务逻辑实现
        return Promise.resolve({ /* GetEntitiesResult 结构的数据 */ });
    }
};

方案2：让esbuild兼容该语法（不推荐） #

如果一定要保留接口里的默认值，可以通过指定--tsconfig参数让esbuild严格遵循项目的tsconfig配置，确保解析规则与tsc对齐：

1. 确保项目根目录存在tsconfig.json，且配置了正确的target（比如"target": "ES2022"）
2. 修改esbuild命令：

esbuild ./lib/index.ts --bundle --minify --sourcemap --target=es2022 --format=esm --outfile=./bundle/index.esm.js --tsconfig=tsconfig.json

不过这种方式依赖esbuild对该TS特性的版本支持，存在兼容风险，仍推荐方案1。

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