在这里补充一下，听起来像是ESLint那边的bug。

在这里插一句，听起来这也是ESLint的问题。
我对@DanielRosenwasser的说法不太有信心：

• return 和 yield 在句法层面上具有不同的含义。
• IterableIterator<T> 是实现细节，代码没有返回可迭代的迭代器，也不是开发者编写的。只是多个 yield 。
• 我找不到任何关于TypeScript定义为 IterableIterator 的标准文档，所以我不指望eslint能知道它。只是好奇：它从哪里来？是TypeScript生成器的内部定义吗？

这是TypeScript生成器的内部定义吗？
它是一个接口(嗯，suite of them),定义了生成器或IterableIterator规范对象的形状：

interface IteratorResult<T> {
    done: boolean;
    value: T;
}
interface Iterator<T> {
    next(value?: any): IteratorResult<T>;
    return?(value?: any): IteratorResult<T>;
    throw?(e?: any): IteratorResult<T>;
}
interface Iterable<T> {
    [Symbol.iterator](): Iterator<T>;
}
interface IterableIterator<T> extends Iterator<T> {
    [Symbol.iterator](): IterableIterator<T>;
}

感谢@weswigham的回复。我已经注意到了(这就是为什么我在JSDoc部分使用它的原因)。我想了解是否有类似HTMLElement的标准定义方式，或者这是否是TypeScript开发者为了模拟可迭代迭代器示例而制定的定义(考虑到PromiseLike<T>)。
无论如何，你解决了我的问题，再次感谢！

原始评论中的 eslint 规则现已弃用，但 https://github.com/gajus/eslint-plugin-jsdoc 可以与 @yield 一起满足(至少在推荐的规则集中)。Typescript 需要 @return。两者都可以使用，但这并不理想：

/**
* @template {boolean} [E=null]
* @template {boolean} [A=null]
* @template {boolean} [T=null]
* @template {boolean} [C=null]
* @param {Node} root Root node to walk
* @param {Object} filter Tree walking options
* @param {E} [filter.element] Yield elements
* @param {A} [filter.attribute] Yield attributes
* @param {T} [filter.text] Yield Text node
* @param {C} [filter.comment] Yield Comment nodes
* @yields {
*  (E extends null ? null : Element) |
*  (A extends null ? null : Attr) |
*  (T extends null ? null : Text) |
*  (C extends null ? null : Comment)
* }
* @return {Iterable<
*  (E extends null ? null : Element) |
*  (A extends null ? null : Attr) |
*  (T extends null ? null : Text) |
*  (C extends null ? null : Comment)
* >} Iterable
*/
export function* iterateNodes(root, filter = {}) {

我在JSDoc中使用了TS语法，所以我禁用了 "jsdoc/valid-types"。除此之外，eslint是满意的。
编辑：Intellisense(TS)也将其解析得很好。

工具提示文档错误已在此提交：microsoft/vscode#164888
编辑2:我认为我应该使用 Generator<T> 而不是 Iterator<T>。

我认为我应该使用 Generator<T> 而不是 Iterator<T>。
看起来是这样。在我的设备上就是这样的。

/** Runs `forEach()` callback over warehouses cache
*
* @returns {Generator<EqShowItem>}
*/
export function* forEachWarehouse() {
    // …
}

然后 [...module.forEachWarehouse()].filter((wh) => …) 可以正确推断类型。