TypeScript是否支持原生函数装饰器？附Python对比示例

我在Python中实现了一个简单的函数装饰器，代码可正常运行：

def decorator(fn):
    def wrapper(args):
        print("calling function")
        fn(args)
    return wrapper


@decorator
def printMyName(name):
    print(name)

printMyName('pengooX')

但尝试在TypeScript中编写类似代码时出现报错，TS代码如下：

function decorator(fn){
    function wrapper(args){
        console.log("calling function")
        fn(args)
    }
    return wrapper
}


@decorator
function printMyName(n){
    console.log(n)
}

printMyName('pengooX')

我想了解TypeScript是否支持原生函数装饰器，若不支持请解释原因及可能引发的问题，我查阅TypeScript官方文档后未找到相关讨论。

回答 #

TypeScript目前不支持原生的函数装饰器语法（直接用@decorator装饰普通函数），原因和相关问题如下：

1. 装饰器提案的范围限制 #

当前JavaScript/TypeScript的装饰器处于Stage 3提案阶段，该提案仅明确支持类、类方法、类属性、访问器等类相关成员的装饰器，普通函数的装饰器并未被纳入当前标准范围。TypeScript作为JS的超集，严格遵循这一提案规范，因此未实现普通函数的装饰器支持。

2. 代码报错的直接原因 #

你写的TS代码报错，是因为TypeScript编译器默认不识别普通函数上的@decorator语法——编译器只允许在类及其成员上使用装饰器，普通函数上的该语法会被判定为无效。

3. 强行使用的潜在风险 #

• 语法兼容问题：如果通过开启旧版装饰器配置（如experimentalDecorators）强行使用，会面临后续标准更新的兼容风险，因为旧版Stage 1提案和当前Stage 3的API逻辑差异极大，未来可能被废弃。
• 类型信息丢失：TypeScript的核心优势是类型检查，普通函数装饰器如果没有正确的类型定义，会导致原函数的参数、返回值类型信息丢失，破坏类型系统的可靠性。

替代实现方案 #

要在TS中实现类似Python装饰器的逻辑，完全可以用高阶函数替代，这是符合TS规范且类型安全的写法：

function decorator<T extends (...args: any[]) => any>(fn: T): T {
    const wrapper = (...args: Parameters<T>) => {
        console.log("calling function");
        return fn(...args);
    }
    return wrapper as T;
}

// 直接调用高阶函数包装目标函数
const printMyName = decorator(function(n: string) {
    console.log(n);
});

printMyName('pengooX');

这种写法既实现了和Python装饰器一致的功能，又保留了TypeScript的类型检查能力。

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