JS注解并非JavaScript原生语法，而是通过JSDoc等工具实现的特殊注释形式，用于提供元数据、生成文档、增强类型提示；常见如@param、@returns用于描述函数参数与返回值，@deprecated标记过时方法，配合编辑器提升可读性与维护性；其本质为注释，不参与运行，区别于TypeScript中可执行的装饰器语法如@Component，后者在编译或运行时触发逻辑，具备实际功能。
JS注解并不是JavaScript语言本身的一部分，不像Java或TypeScript中有正式的“注解（Annotation）”语法。但在实际开发中，我们常说的“JS注解”通常指的是在JavaScript代码中使用的一种特殊注释形式，主要用于为工具、框架或开发环境提供元数据信息。
JS注解的实际含义
在纯JavaScript中，并没有像@Override或@Deprecated这样的原生注解支持。所谓的“JS注解”多见于以下场景：
- 使用JSDoc工具编写的文档注释，如@param、@return、@deprecated
- 在TypeScript中使用的装饰器（Decorators），如@Component、@Injectable
- 某些构建工具或框架（如Angular、Babel插件）识别的标记性注释
这些“注解”本质上是注释或特殊的标识语法，用来增强代码的可读性、可维护性，或供工具解析生成文档、进行类型检查、实现依赖注入等。
JSDoc中的常见注解用法
JSDoc是最典型的“JS注解”应用场景。它通过特定格式的注释为函数、类、变量等添加描述和类型信息。
例如：
/**
* 计算两个数的和
* @param {number} a - 第一个加数
* @param {number} b - 第二个加数
* @returns {number} 两数之和
* @deprecated 使用 addNumbers 替代
*/
function add(a, b) {
return a + b;
}
上述代码中的@param、@returns、@deprecated就是JSDoc注解，它们不会影响程序运行，但能被编辑器识别，提供智能提示，也能被JSDoc工具生成API文档。
注解的基本作用
尽管JavaScript不直接执行这些注解，但它们在现代开发中起着重要作用：
- 提升代码可读性：通过描述参数、返回值、作者等信息，帮助开发者理解代码用途
- 支持类型推断：配合VS Code等编辑器，即使在.js文件中也能获得类似TypeScript的类型提示
- 生成文档：使用JSDoc工具可自动生成项目API文档
- 辅助工具处理：一些构建工具或IDE可根据注解进行静态分析、优化或代码生成
与TypeScript装饰器的区别
需要注意的是，TypeScript中的装饰器（Decorators）是一种真正的语言特性，使用@符号修饰类、方法、属性等，并在运行时或编译时执行逻辑。这与JS中的注释型“注解”有本质区别。
例如：
@Component({
selector: 'app-user',
template: './user.component.html'
})
class UserComponent {}
这里的@Component是装饰器，会触发实际的元数据配置逻辑，而不仅仅是注释。
基本上就这些。JS注解虽非语言原生概念，但在工程实践中非常实用，尤其结合JSDoc和现代开发工具后，能显著提升开发效率和代码质量。正确使用这些“伪注解”，能让JavaScript项目更规范、更易维护。
