Vue 3 + Vite + TypeScript dev与build未捕获TS类型错误

核心问题原因 #

• 构建脚本执行逻辑错误：当前package.json中build命令使用run-p（npm-run-all 并行执行指令）同时运行类型检查和Vite构建任务。Vite默认仅做TS语法转译，不执行类型校验，且并行执行模式下Vite构建不会等待vue-tsc类型检查的结果，只要自身打包流程完成就会返回成功，哪怕类型检查抛出错误，构建流程也不会中断。
• 示例代码本身存在明确可触发的TS错误：未定义StoredResource类型、错误将字符串值断言为number类型，这类错误本应被类型检查拦截。

修复方案 #

1. 调整构建脚本执行顺序 #

将构建流程从「并行执行类型检查+打包」改为「先串行执行类型检查，检查通过后再打包」。修改package.json中的build脚本：

"build": "run-s type-check build-only",

run-s是npm-run-all提供的串行执行指令，会按顺序执行后续任务，只要前置的type-check任务检测到类型错误、返回非0退出码，整个构建流程会直接中断，不会执行后续的Vite打包步骤。

2. 校验类型检查配置有效性 #

当前type-check命令引用了tsconfig.vitest.json配置文件，请确认该文件正确继承了根目录tsconfig.json的校验规则，覆盖所有src目录下的.ts、.vue文件。如果存在配置引用错误，可临时将type-check命令改为直接读取根目录TS配置，避免检查失效：

"type-check": "vue-tsc --noEmit -p tsconfig.json --composite false",

3. 效果验证 #

修改完成后执行npm run build，如果代码中存在类型错误，终端会先输出vue-tsc抛出的具体错误信息，进程直接退出，不会执行后续打包操作；只有所有类型错误修复完成，才会启动Vite生产构建，完全满足类型错误阻断构建的需求。

可选优化 #

如果需要本地开发时在终端实时显示类型错误，可调整dev脚本，并行启动类型检查和开发服务（开发模式为常驻进程，并行不会影响阻断逻辑）：

"dev": "run-p type-check dev:only",
"dev:only": "vite"

内容的提问来源于stack exchange，提问作者Rafal Adam Krohne