导入@types/ziggy-js引发Vite报错，Laravel项目TS全局类型问题求助

核心方案：全局类型声明文件 #

不用在每个文件重复编写类型导入，只需要创建一个全局类型声明文件，一次性解决所有文件的类型识别问题：

1. 创建全局类型声明文件
   在项目的src目录下新建types/ziggy.d.ts（或者直接在项目根目录创建ziggy.d.ts），写入以下内容：

import type { RouteFunction } from '@types/ziggy-js';

declare global {
  const route: RouteFunction;
}

export {};

注：export {}是为了让TS将这个文件识别为模块，避免"Augmentations for the global scope can only be directly nested in external modules or ambient module declarations."的报错

2. 配置TypeScript识别该文件
   打开tsconfig.json，确保include数组包含你的类型文件路径，比如：

{
  "compilerOptions": {
    // 你的其他配置项
  },
  "include": [
    "resources/js/**/*",
    "src/types/**/*.d.ts" // 对应你刚才创建的类型文件路径
  ]
}

3. 验证效果
   重启PHPStorm让它重新索引项目，之后所有文件里使用route()函数时，TypeScript会自动识别其类型，不会再报未定义的错误，同时Vite也不会出现文件找不到的问题。

原理说明 #

通过declare global扩展TypeScript的全局作用域，将route函数的类型绑定到全局变量上，这样所有文件都能共享这个类型定义，省去了每个文件重复导入类型的麻烦。@types/ziggy-js包提供的RouteFunction类型正好匹配Ziggy全局route()函数的类型签名。

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