Vue3+Vite项目执行npm run build失败，报endsWith未定义错误

问题根源 #

你的tsconfig.json中references数组存在不符合规范的配置项：第三个对象没有path字段，而是直接写入了compilerOptions。TypeScript的Project References规范要求每个引用项必须包含path，指向对应的子tsconfig文件；而Vite的TS配置解析函数会遍历所有引用项并尝试读取path属性，当遇到无path的对象时，ref.path为undefined，调用endsWith方法就会抛出你看到的类型错误。

解决方案 #

修正tsconfig.json的references配置，移除那个包含compilerOptions的无效引用项。如果需要自定义编译选项，请将其写入对应的子tsconfig文件（比如tsconfig.node.json或tsconfig.app.json）中。

修正后的配置示例：

{
  "files": [],
  "references": [
    {
      "path": "./tsconfig.node.json"
    },
    {
      "path": "./tsconfig.app.json"
    }    
  ]
}

验证 #

修改完成后重新执行npm run build，构建应该能正常完成。

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