如何在IntelliJ中为前端Monorepo设置默认Vitest测试环境

项目结构 #

- apps
  - foo
    - package.json
    - src
    - test
- libs (结构同apps)

1. 设置默认使用Vitest替代Jest #

1. 打开IntelliJ设置（File > Settings，或快捷键Ctrl+Alt+S）
2. 导航到Languages & Frameworks > JavaScript > Testing Frameworks
3. 在框架列表中：
   • 找到Jest，取消勾选Enable禁用它
   • 找到Vitest，勾选Enable后点击Configure
   • 在Vitest配置弹窗中，选择Package.json路径：若monorepo根目录有统一的vitest配置，选根目录的package.json；若子包独立配置，可选择对应子包的package.json（建议根目录统一配置，方便全局管理）
4. 保存设置后，IntelliJ会自动识别项目中的Vitest测试文件，默认运行器切换为Vitest

2. 右键任意文件夹执行该文件夹内的测试 #

当前右键显示Python测试选项，是因为IntelliJ错误关联了文件类型，按以下步骤修复：

1. 修正文件类型关联：
   • 打开设置File > Settings > Editor > File Types
   • 在Recognized File Types中找到Python，移除所有不属于Python的文件后缀（比如.js、.ts、.jsx、.tsx）
   • 找到JavaScript和TypeScript，确保对应的后缀都已添加
2. 配置Vitest测试范围触发：
   • 确保每个子包的package.json中添加Vitest脚本：

     "scripts": {
       "test": "vitest",
       "test:folder": "vitest run --dir"
     }
     

   • 右键任意文件夹时，选择Run 'npm run test -- --dir [当前文件夹路径]'，或直接选择Run 'Vitest in [文件夹名]'（IntelliJ识别到Vitest配置后会自动出现该选项）
   • 若需更快捷触发，可创建Vitest运行模板：
     • 打开Run > Edit Configurations，点击+选择Vitest，配置模板名称为Vitest Folder，在Test kind中选择Directory，保存为模板。之后右键文件夹即可直接选择该模板运行

3. 导出配置供其他开发者使用 #

不要直接导出单个.run.xml文件，IntelliJ共享配置需通过以下方式：

1. 共享测试框架配置：
   • IntelliJ的测试框架配置存储在.idea/jsTestFramework.xml文件中，将该文件提交到仓库
   • 调整.gitignore，确保没有忽略这个文件（默认.gitignore可能会忽略.idea/下部分文件）
2. 共享运行配置模板：
   • 打开Run > Edit Configurations，选择你创建的Vitest模板，点击Store in project，.idea/runConfigurations/下会生成对应配置文件，将该文件夹下的共享配置提交到仓库
3. 导出全局设置（可选）：
   • 若需共享更多编辑器设置（如代码风格、快捷键），可通过File > Export Settings导出为.jar文件，将该文件放入仓库，其他开发者通过File > Import Settings导入
4. 避免XML加载错误：
   • 不要手动移动单个.run.xml文件，确保配置文件在.idea/runConfigurations/目录下，IntelliJ会自动加载该目录下的配置

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