Monorepo中Vite在client目录生成独立node_modules的问题求助

问题本质 #

你遇到的client/node_modules/.vite/deps_temp是Vite依赖预构建的临时目录，正常情况下在npm Workspaces架构下，Vite应该复用根目录的node_modules，出现这个问题要么是Vite没识别到根依赖路径，要么是Workspaces配置有疏漏。

分步解决 #

1. 确认根目录Workspaces配置 #

先检查根package.json的Workspaces设置是否正确：

{
  "name": "your-monorepo-root",
  "private": true, // 必须设为true，否则Workspaces不生效
  "workspaces": [
    "./client", // 精确匹配你的client子包路径
    // 其他子包路径比如"./server"
  ]
}

如果之前在client目录单独执行过npm install，删掉client下的node_modules，然后在根目录重新跑npm install，确保所有依赖都安装到根目录。

2. 修改Vite配置指向根依赖 #

在client/vite.config.js里添加以下配置，强制Vite使用根目录的依赖和缓存：

import { defineConfig } from 'vite'
import path from 'path'

export default defineConfig({
  resolve: {
    preserveSymlinks: true, // 防止Vite解析依赖时跳转到子包路径
    // 可选：给常用依赖加别名，直接指向根node_modules
    alias: {
      'react': path.resolve(__dirname, '../node_modules/react'),
      'react-dom': path.resolve(__dirname, '../node_modules/react-dom')
    }
  },
  optimizeDeps: {
    // 把预构建缓存放到根目录的node_modules下，避免子包重复生成
    cacheDir: path.resolve(__dirname, '../node_modules/.vite'),
    esbuildOptions: {
      // 告诉esbuild从根依赖查找所有包
      paths: {
        '*': [path.resolve(__dirname, '../node_modules/*')]
      }
    }
  }
})

3. 重新启动验证 #

在根目录执行启动命令：

npm run dev -ws client

启动后检查client目录，应该不会再生成node_modules/.vite/deps_temp，所有预构建文件都会存到根node_modules/.vite下。

额外检查项 #

• 确保client的package.json里的依赖都没有在本地单独安装（即client下没有自己的node_modules）
• 如果某些第三方依赖还是被单独预构建，检查根package.json是否已经声明了这些依赖，Workspaces会自动把子包的依赖提升到根目录

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