JSDoc是否支持为连续声明的多个变量批量标注@type类型

原生语法支持情况 #

目前JSDoc没有提供对应原生语法支持你期望的写法。
JSDoc的核心绑定规则是：单个独立的JSDoc注释块，只会绑定到它紧后方的第一个代码节点。你设想的「连续多个@type注释块按从上到下的顺序，依次对应下方多个连续声明的变量」的逻辑，既不符合现有JSDoc解析规则，也没有被VS Code内置JS类型检查、TypeScript checkJs模式等主流JSDoc兼容实现支持。按照你写的期望写法实际运行解析时，只有最靠近变量的最后一个@type注释会绑定到第一个声明的变量上，后续的变量都不会被关联到对应类型，完全达不到逐行标注的效果。
你提到的@param集中标注逻辑和这个需求有本质区别：所有@param标签都写在同一个绑定到函数声明的JSDoc注释块内部，注释块和函数是一对一绑定关系，块内的@param是通过参数名和函数形参列表做精准匹配，不是靠从上到下的顺序对应，二者的实现逻辑并不相通。
你考虑过的注释和变量写在同一行的方案确实存在行过长、对齐成本高、不符合多数团队代码规范的问题，不推荐使用。

可行的折中方案 #

目前要兼顾可读性和类型解析正确性，可以参考这几个方案：

• 标准写法：还是采用逐变量前置@type注释的写法，这是所有JSDoc实现都100%兼容的方案，不会出现类型绑定错误，虽然注释占行较多，但长期维护成本最低。
• 同类型变量合并声明：如果是多个相同类型的连续变量，可以合并到同一条变量声明语句中，共用一个@type注释，减少冗余注释行数，例：

/** @type {number | null} */
let srcTagNum = null, srcLevelNum = null;

注意这个方案仅适用于同类型变量，不同类型变量无法共用类型标注。

• 区块补充说明：如果是关联度很高的一组变量，可以在变量区块最开头加一个统一的JSDoc注释块说明整组变量的作用，单个变量的@type注释还是保留在对应变量上方，兼顾整组变量的可读性和类型解析准确性。

特性建议提交渠道 #

如果希望推动JSDoc官方支持这个语法，可以到JSDoc官方开源仓库的Issue提交入口反馈需求，提交建议时最好附上：

• 具体的语法设计示例
• 和现有@param语法的逻辑参照说明
• 该特性能解决的实际开发痛点
• 对应的真实使用场景案例

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