VS Code中无法识别已引入文件内的myFun函数，如何解决？

问题原因 #

你使用的<include src="my-funs.js">属于构建工具层面的非标准注入语法——运行时浏览器能通过全局作用域拿到myFun和dummy，但TypeScript做静态分析时无法识别该标签的注入逻辑，因此找不到对应的函数/变量声明。

可行解决方案 #

方案1：改用标准ES模块导入（推荐） #

如果项目支持模块化，调整文件结构实现标准导入：

• 修改my-funs.js，导出函数和变量：

  // @ts-check
  /**
   * @param {*} type 
   * @param {*} attrib 
   * @param {*} inner 
   * @returns {*}
   */
  export function myFun(type, attrib, inner) {
    // code
  }
  
  export var dummy = ...;
  

• 在主文件中通过import引入：

  // @ts-check
  import { myFun, dummy } from './my-funs.js';
  
  // 正常使用myFun和dummy
  

方案2：声明全局变量/函数（兼容原有全局挂载逻辑） #

如果必须保持全局挂载的方式，可通过以下两种方式实现：

1. 在JS文件中显式挂载到全局对象
   修改my-funs.js，将函数和变量挂载到globalThis（浏览器环境等价于window），同时用JSDoc标注类型：

   // @ts-check
   /**
    * @param {*} type 
    * @param {*} attrib 
    * @param {*} inner 
    * @returns {*}
    */
   function myFun(type, attrib, inner) {
     // code
   }
   var dummy = ...;
   
   // 显式挂载到全局
   /** @type {typeof myFun} */
   globalThis.myFun = myFun;
   /** @type {typeof dummy} */
   globalThis.dummy = dummy;
   

2. 创建TypeScript声明文件
   在项目根目录新建my-funs.d.ts文件，手动声明全局类型：

   declare function myFun(type: any, attrib: any, inner: any): any;
   declare var dummy: any;
   

   确保该文件被TypeScript识别：若项目有tsconfig.json或jsconfig.json，在include数组中添加"./*.d.ts"；无配置文件时直接放在根目录即可。

方案3：通过配置文件让TypeScript扫描目标文件 #

若不想修改代码，可创建jsconfig.json（纯JS项目）或tsconfig.json（TS/混合项目），指定TypeScript需要扫描的文件范围：

{
  "include": [
    "./my-funs.js",
    "./你的主文件.js"
  ]
}

这种方式仅当my-funs.js中的函数为全局声明时有效，且依赖文件的扫描顺序。

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