PhpStorm引入外部模块后自定义类型与Jest匹配器Intellisense失效问题

1. PhpStorm中引入其他模块时保留自定义类型Intellisense #

• 给被引入模块添加类型注释：自定义模块里，用/** @type {xxx} */标注导出值的类型，比如导出字符串就写/** @type {string} */ module.exports = 'foo';，复杂类型可以先用@typedef定义再标注。
• 开启IDE类型推断增强：打开Settings > Languages & Frameworks > JavaScript > Libraries，勾选Enable TypeScript service（适合JS/TS混合或纯JS项目）；再进入Settings > Editor > General > Code Completion，确保自动补全弹窗的相关选项都处于开启状态。
• 显式标注引入变量的类型：在引入代码旁直接加类型注释，比如/** @type {string} */ const foo = require('./foo');，强制IDE识别变量类型。

2. Jest自定义匹配器引入外部模块后Intellisense消失的修复 #

你遇到的问题是因为PhpStorm无法自动推断require('./foo')的具体类型，导致匹配器内部的类型关联中断。可以试试这几个方法：

方法一：给引入的变量加类型注释 #

直接明确foo的类型，让IDE清楚它是字符串类型：

/** @type {string} */
const foo = require('./foo');

/**
 * @typedef {jest.Expect} expect
 * @property {Function} toEqualFoo
 */
expect.extend({
  toEqualFoo(received) {
    const pass = received === foo;
    return {
      pass,
      message: () => `expected ${received} to equal foo`
    }
  }
});

方法二：给被引入的foo.js加类型注释 #

在./foo.js文件顶部添加注释，明确导出内容的类型：

// foo.js
/** @type {string} */
module.exports = 'foo';

这样IDE会自动识别foo的类型，匹配器的智能提示就能恢复正常。

方法三：使用TypeScript类型声明文件（项目支持的话） #

如果项目允许添加.d.ts文件，创建foo.d.ts：

declare module './foo' {
  const foo: string;
  export default foo;
}

IDE读取这个类型声明后，就能正确推断变量类型，智能提示即可恢复。

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