通过jsDoc注解可明确javaScript函数参数的必填性，提升代码可读性与维护性。使用@param标注参数类型和说明，默认为必填；用[options]或?标记可选参数，反之则视为必填。配合typescript能更严格校验必填参数，建议团队开发中统一使用JSDoc并结合工具检查，确保接口清晰、减少调用错误。
javascript 本身没有原生的参数必填机制，但通过注解（如 JSDoc）可以明确标注哪些参数是必填的，提升代码可读性和维护性。虽然 JS 不会因缺少参数而报错（除非运行时逻辑出错），但使用 JSDoc 注解能帮助开发者和工具（如 ide、TypeScript）理解函数意图。
使用 JSDoc 标注必填参数
JSDoc 是最常用的 JavaScript 注释规范，支持对函数参数进行详细说明，包括类型、是否必填、默认值等。
在 JSDoc 中，@param 用于描述参数，语法如下：
/** * 计算两个数的和 * @param {number} a – 第一个加数（必填） * @param {number} b – 第二个加数（必填） * @returns {number} 两数之和 */ function add(a, b) { return a + b; }
上面例子中，a 和 b 都没有标记为可选，因此默认视为必填参数。
明确标注可选参数，反向突出必填
JSDoc 中，使用 ? 或 = 表示参数可选。反过来，不加这些符号的参数即为“必填”。
例如：
/** * 发送请求 * @param {String} url – 请求地址（必填） * @param {Object} [options] – 配置项（可选） * @param {Function} callback – 回调函数（必填） */ function request(url, options, callback) { // … }
这里 [options] 表示它是可选参数，url 和 callback 没有方括号，表示必须传入。
结合 TypeScript 更精准控制
若项目使用 TypeScript，可以直接在函数签名中标注参数类型，未使用 ? 的参数即为必填：
function createUser(name: string, age: number, email?: string): void { // name 和 age 是必填，email 是可选 }
TypeScript 编译器会在开发阶段提示缺失的必填参数，比纯 JS + JSDoc 更严格有效。
实际开发建议
即使不使用 TypeScript，也推荐在团队项目中统一使用 JSDoc 注解，尤其要：
- 为每个函数添加 JSDoc 注释
- 明确写出参数类型和说明
- 用 [param] 或 param? 标记可选参数
- 不加标记的视为必填，保持一致性
- 配合 ESLint 或 IDE 工具检查文档完整性
基本上就这些。JS 虽灵活，但良好的注解习惯能让函数接口更清晰，减少调用错误。标注必填参数的关键在于“默认即必填，可选需声明”。