Monorepo 中用 Vite 高效引用本地依赖包的关键是让 Vite 直接读取源码而非预构建，依赖 pnpm workspace 符号链接与正确 package.json name 解析，配合 tsconfig paths 别名、Turborepo 增量构建实现零拷贝、实时更新与类型即用。
在 Monorepo 中用 Vite 高效引用和编译本地依赖包，关键不是“手动链接”或“硬编码路径”，而是让 Vite 正确识别本地包为源码（而非第三方依赖），并配合包管理器（如 pnpm）的 workspace 机制实现零拷贝、实时更新、类型即用。
本地包必须走源码路径，不能被预构建
Vite 默认只对 裸模块导入（如 import React from 'react'）触发依赖预构建；而对本地 workspace 包（如 import { utils } from '@myorg/shared'），只要路径解析正确，Vite 就会直接读取 packages/shared/src 源码，跳过 node_modules/.vite/deps 缓存。这是高效的基础。
- 确保 pnpm workspace 已正确定义（
pnpm-workspace.yaml包含- 'packages/*'等规则） - 本地包的
package.json中需声明"types": "src/index.ts"或"types": "dist/index.d.ts"（若已构建） - 根目录
tsconfig.base.json或tsconfig.json中配置"baseUrl": "."和"paths"（可选，但推荐用于 IDE 跳转）
统一类型与路径别名，避免相对路径混乱
跨 packages 导入时写 ../../../shared/src/utils 不仅难维护，还破坏 Vite 的 HMR 连续性。应通过标准方式建立可解析的包名引用。
- pnpm 会自动在根
node_modules中创建符号链接（例如@myorg/shared → ../packages/shared），所以只要 import 使用包名即可 - Vite 不需要额外配置 alias 就能解析 workspace 包——前提是你的
import语句匹配 package.json 的name字段（如"name": "@myorg/shared"） - 若使用 TypeScript，建议在根
tsconfig.json中加入："compilerOptions": { "moduleResolution": "bundler", "allowSyntheticDefaultImports": true }
构建时按需输出，避免全量打包本地依赖
本地包（如 UI 组件库）通常以库模式（build.lib）构建，不参与应用的主打包流程；Vite 应用开发时只加载其源码，生产构建时才由 Rollup 合并或外链。
- 本地包的
vite.config.ts应启用build.lib，指定entry和formats（如['es', 'umd']） - 应用包中无需
optimizeDeps.include加入本地包名——加了反而会强制预构建，失去源码热更新优势 - 如需在开发中调试组件库的构建产物（如 dist），可临时在应用的
vite.config.ts中配置：resolve.alias: { '@myorg/shared': path.resolve(__dirname, '../packages/shared/dist/index.js') }，但日常开发不推荐
利用 Turborepo 实现跨包增量构建与缓存复用
单靠 Vite 无法解决多包并行构建的协调问题。Turborepo 可基于文件改动自动跳过未变更包的构建，并复用上一次的 dist 输出。
- 在
turbo.json中定义build任务依赖链："dependsOn": ["^build"]，确保@myorg/shared先构建完成，再构建依赖它的@myorg/frontend - Turborepo 会根据
package.json、src/**、vite.config.ts等作为输入指纹，哪怕只改一行 TS，也会精准重跑对应包 - 搭配 pnpm + Turborepo，一个
turbo build命令就能完成整个 Monorepo 的最小化构建，且结果可被 CI/CD 缓存
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
