JavaScript无原生注解语法，但可通过函数属性、高阶函数、Symbol元数据及Reflect API模拟。1. 直接添加自定义属性如func.author = 'John'；2. 用高阶函数实现装饰器行为，如@log需Babel/TypeScript支持；3. 使用Symbol避免属性冲突，私有存储元数据；4. 借助reflect-metadata库结合Reflect.defineMetadata实现类与方法的元信息管理，广泛用于Angular、NestJS等框架。
JavaScript 本身没有“注解”（Annotation）这种语法，像 Java 或 TypeScript 中的装饰器（Decorator）那样的注解功能，在原生 JS 中并不存在。但你提到的“JS 注解自定义属性”，可能是想表达：如何在 JavaScript 中模拟类似注解的行为，或如何给函数、对象添加自定义元数据（即自定义属性），用于后续处理。
下面介绍几种常见的实现方式，帮助你在 JS 中定义和使用“自定义属性”，达到类似“注解”的效果。
1. 给函数或对象直接添加自定义属性
JavaScript 是动态语言，允许随时给函数或对象添加属性，这是最简单的“自定义注解”方式。
示例：function getUser() {
return { id: 1, name: 'Alice' };
}
// 添加自定义属性，模拟“注解”
getUser.author = 'John';
getUser.version = '1.0';
getUser.description = '获取用户信息接口';
// 使用这些“注解”属性
console.log(getUser.author); // 输出: John
console.log(getUser.description); // 输出: 获取用户信息接口
这种方式简单直接，适合在框架或工具中为函数打标签、记录元信息。
2. 使用高阶函数模拟注解行为
通过封装一个函数来“装饰”目标函数，并附加元数据或逻辑，是更接近“注解”概念的做法。
示例：创建一个 @log 注解模拟function log(target) {
target.shouldLog = true;
return target;
}
@log
function fetchData() {
if (fetchData.shouldLog) {
console.log('正在调用 fetchData...');
}
return 'data';
}
注意：上面的 @log 语法属于 JavaScript 装饰器提案，目前尚未正式纳入标准，需要借助 Babel 或 TypeScript 支持才能运行。
3. 使用 Symbol 存储私有元数据
为了避免自定义属性名冲突，可以使用 Symbol 来作为唯一的属性键。
const Metadata = Symbol('metadata');
function setMetadata(target, data) {
target[Metadata] = data;
}
function getMetadata(target) {
return target[Metadata];
}
function apiRoute(path) {
return function(target) {
setMetadata(target, { type: 'api', path });
return target;
};
}
const getUser = apiRoute('/user')(function() {
return { id: 1 };
});
console.log(getMetadata(getUser)); // { type: 'api', path: '/user' }
这样可以安全地附加元信息，不会污染对象原有属性。
4. 结合 Reflect 和 Proxy 实现高级元数据管理
使用 Reflect.defineMetadata 需要引入第三方库如 reflect-metadata，常见于 TypeScript 装饰器开发。
npm install reflect-metadata使用示例：
import 'reflect-metadata';
function Route(path: string) {
return function(target: any, propertyKey: string | symbol) {
Reflect.defineMetadata('route:path', path, target, propertyKey);
};
}
class UserController {
@Route('/users')
list() {}
}
const path = Reflect.getMetadata('route:path', UserController.prototype, 'list');
console.log(path); // 输出: /users
这种方式广泛应用于 Angular、NestJS 等框架中，实现依赖注入和路由映射。
基本上就这些常见的做法。虽然原生 JS 没有真正的注解语法，但通过属性扩展、装饰器函数、Symbol 和元数据反射机制，完全可以实现类似“自定义注解属性”的功能。
