如何在Monorepo的包目录中配置Vitest以正常运行测试？

我太懂这种头疼的情况了——VSCode插件自动切到子包目录跑测试，结果因为模块别名解析直接报错，明明文件就在那儿却找不到！咱们来一步步解决这个问题：

问题根源 #

当你进入子包目录执行Vitest时，它默认会优先读取当前目录的配置文件，如果子包没有单独配置，虽然会向上查找根目录的配置，但别名的路径解析是基于当前工作目录的，不是根目录，这就导致@shared/utils这类别名在子包环境下没法正确指向对应的文件。

具体解决方案 #

方案一：用绝对路径定义根配置里的别名（推荐）

修改根目录的vitest.config.ts，用Node的path模块动态生成绝对路径，这样不管你在哪个目录运行Vitest，别名解析都不会出错：

import { defineConfig } from 'vitest/config';
import path from 'path';

export default defineConfig({
  resolve: {
    alias: {
      // 用__dirname（根目录路径）拼接目标文件的绝对路径
      '@shared/utils': path.resolve(__dirname, 'packages/shared/utils'),
      // 其他项目别名也按这个格式调整
    },
  },
  // 你的其他Vitest配置（比如test目录、环境等）
});

同时别忘了同步调整tsconfig.json里的paths配置，保持和Vitest别名一致：

{
  "compilerOptions": {
    "paths": {
      "@shared/utils": ["./packages/shared/utils"]
    }
  }
}

方案二：给子包添加继承式配置

如果你的子包需要单独的Vitest配置，可以在子包目录（比如packages/some-package）创建vitest.config.ts，继承根配置并修正别名路径：

import { defineConfig } from 'vitest/config';
import rootConfig from '../../vitest.config';

export default defineConfig({
  ...rootConfig,
  resolve: {
    ...rootConfig.resolve,
    alias: {
      // 基于当前子包路径指向根目录的目标文件
      '@shared/utils': '../../packages/shared/utils',
    },
  },
});

这个方法适合需要给不同子包定制测试规则的场景，但包多的话会有点繁琐。

方案三：给子包的package.json添加测试脚本

如果VSCode插件支持运行package.json里的脚本，可以在子包的package.json中添加指定根配置的测试命令：

{
  "scripts": {
    "test": "vitest run --config ../../vitest.config.ts"
  }
}

之后在子包目录执行pnpm test -t "你的测试名称"就能正常跑测试了，插件如果能识别这个脚本的话，直接调用也没问题。

验证步骤 #

改完配置后，先在子包目录手动执行测试命令试试：

npx vitest run -t "Given a Config loader"

如果模块解析正常，说明配置生效了～

备注：内容来源于stack exchange，提问作者Adam A