在 vite 项目中配置 monorepo，核心做法是利用 vite 的 `resolve.alias` 和 `optimizedeps.exclude` 功能，将根目录下的共享包映射到本地路径，并排除这些包以避免预构建失败。具体操作是在每个子应用的 vite.config.js 中定义别名指向 workspace 包，同时在 exclude 列表中声明这些包，这样 vite 就能直接读取源码而无需额外打包。
Vite alias 如何正确映射 workspace 包
通过配置 resolve.alias 可以将导入语句重定向到 monorepo 中的本地包。例如，当代码中引入 @my/shared-utils 时，Vite 会将其解析为 ../packages/shared-utils/src/index.ts。这确保了开发服务器能直接处理 TypeScript 或 JSX 源码，而不需要预先编译。
import { defineConfig } from 'vite';
import path from 'path';
export default defineConfig({
resolve: {
alias: {
'@shared': path.resolve(__dirname, '../packages/shared/src'),
},
},
});
为什么需要 optimizeDeps.exclude
Monorepo 中的内部包通常包含未编译的源码，如果 Vite 尝试对它们进行预构建（Optimize Deps），可能会因为依赖缺失或格式问题报错。通过在 optimizeDeps.exclude 中列出这些包，可以告诉 Vite 跳过预构建步骤，直接在运行时处理这些模块。这是解决 monorepo 开发环境常见错误的必要步骤。
立即学习“Java免费学习笔记（深入）”；
import { defineConfig } from 'vite';
export default defineConfig({
optimizeDeps: {
exclude: ['@my/shared-utils', '@my/core-lib'],
},
});
alias 配置错误会导致什么结果
如果 resolve.alias 的路径配置错误，或者没有正确排除依赖，Vite 启动时会抛出 Cannot find module 或 ERR_MODULE_NOT_FOUND 错误。此外，若未排除内部包，Vite 可能在热更新时出现循环依赖警告，导致页面刷新异常。正确的配置应确保路径绝对且排除列表完整。
