JS函数参数默认值可通过ES6语法设置，如function greet(name = “游客”, age = 18)；JSDoc用@param {type} [name=default]标注，默认值需与代码一致，提升可读性、支持智能提示并便于维护。
在JavaScript中，函数参数的默认值可以通过ES6语法直接定义，而JS注解（如JSDoc）则用于为开发工具和团队提供类型提示与文档说明。虽然JS本身是动态类型语言，但通过JSDoc可以模拟静态类型的标注方式，提升代码可读性和维护性。
JS函数参数默认值的基本写法
ES6支持在函数定义时直接设置参数默认值：
function greet(name = “游客”, age = 18) {
console.log(`你好，${name}，你今年${age}岁。`);
}
上述代码中，name 和 age 都有默认值。如果调用函数时未传参，就会使用这些默认值。
JSDoc中如何标注带默认值的参数
JSDoc通过 @param 标签来描述参数类型和说明，若参数有默认值，可以用等号 = 显式标注。
/**
* 欢迎用户
* @param {string} [name=”游客”] – 用户名，默认为”游客”
* @param {number} [age=18] – 年龄，默认为18
*/
function greet(name = “游客”, age = 18) {
console.log(`你好，${name}，你今年${age}岁。`);
}
注意点：
方括号 [name=”游客”] 表示该参数是可选的，并且默认值为“游客”{string} 定义类型，有助于IDE进行类型推断和错误检查即使不写方括号，加上默认值后参数自然就是可选的
使用JSDoc的好处
尽管JavaScript运行时不依赖注解，但JSDoc能带来实际帮助：
增强代码可读性，让其他开发者快速理解参数用途和默认行为配合VS Code、WebStorm等编辑器实现智能提示和自动补全与TypeScript工具链兼容，便于后期迁移或类型检查生成API文档，适合大型项目维护
常见注意事项
使用默认值和JSDoc标注时需留意以下细节：
实际默认值必须与JSDoc中标注的一致，避免误导对象或数组的默认值建议用 @example 补充说明复杂类型可用 {Object} 配合 @property 进一步描述结构
基本上就这些。合理使用JSDoc标注函数参数默认值，能让JS代码更清晰、更健壮，尤其在团队协作或长期维护项目中作用明显。
以上就是JS注解怎么标注默认值_ JS函数参数默认值的注解写法与作用的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1534987.html
微信扫一扫 
支付宝扫一扫 
