Rolldown项目中命名空间与类型合并导致的导出丢失问题分析

问题概述

在Rolldown项目的TypeScript代码打包过程中，发现当使用命名空间(Foo)与接口/类型别名进行声明合并时，会导致命名空间未被正确导出的问题。这是一个值得开发者注意的TypeScript编译边界情况。

问题现象

当代码中存在以下结构时：

export interface Foo {
    id: string
}

export namespace Foo {
    export function x() {
        return ''
    }
}

编译后的输出会丢失对Foo命名空间的导出，仅保留了命名空间内部的实现代码。这与TypeScript官方Playground展示的预期行为不符。

技术背景

TypeScript的声明合并(Declaration Merging)允许将相同名称的不同类型声明合并为一个定义。命名空间可以与类、函数、枚举以及接口/类型别名进行合并。这种特性常用于扩展已有类型定义。

根本原因

经过分析，这个问题源于底层编译器(oxc)在最近对命名空间相关实现的调整。当类型声明(interface/type)位于命名空间之前时，编译器未能正确处理导出逻辑。

解决方案

目前有两种解决方案：

1. 调整声明顺序：将命名空间声明置于类型声明之前

export namespace Foo {
    export function x() {
        return ''
    }
}

export interface Foo {
    id: string
}

2. 等待编译器修复：相关修复已在oxc项目的PR中提交，后续版本将解决此问题。

最佳实践建议

1. 在使用声明合并时，建议保持一致的声明顺序
2. 对于关键导出，添加显式的导出语句作为保障
3. 在升级编译器版本后，验证声明合并的行为是否符合预期

总结

这个问题展示了TypeScript高级特性在实际编译过程中的边界情况。开发者在使用声明合并时应当注意编译器的具体实现细节，特别是在构建工具链中使用时，需要关注不同工具间的行为差异。随着相关修复的合并，这一问题将得到解决，但理解其背后的机制对于处理类似问题仍有重要意义。