解决什么问题

想要使用本地 monorepo 开发 + 纯 npm 管理的项目，不想对项目进行 pnpm 改造的开发者

项目地址

https://github.com/alamhubb/mono

Mono

零侵入式 Monorepo 开发工具

直接使用 TypeScript 源码开发，无需构建，无需改造项目

什么是 Mono？

Mono 是一套零侵入式 monorepo 开发工具。它允许你在开发期间直接使用 TypeScript 源码，无需构建包或重构项目。

pnpm workspace 的「链式污染」问题

使用 pnpm workspace 意味着整条依赖链都被迫使用 pnpm：

项目 A (pnpm) → 必须用 pnpm
  └── 项目 B → 必须用 pnpm（被污染）
        └── 项目 C → 必须用 pnpm（被污染）
              └── 项目 D → 必须用 pnpm（被污染）

• 所有相关项目都必须改成 pnpm
• 所有开发人员都必须安装 pnpm
• 所有 CI/CD 环境都必须配置 pnpm
• 新成员 npm install 直接报错：workspace:*

详细分析请阅读：「链式污染」—— 为什么一个 pnpm 项目会逼着整条依赖链都改成 pnpm

Mono 的解决方案

使用 Mono，你只需：

• 运行 mono ./src/index.ts - 就这么简单！
• 无需重构项目，无需 workspace:*
• 无需构建包，直接使用源码
• 修改立即生效，npm/yarn/pnpm 都兼容

pnpm workspace vs Mono

包列表

本仓库包含两个协同工作的包：

何时使用哪个？

快速开始

1. 全局安装 CLI

npm install -g mono-mjs

2. 运行项目

# 直接运行 TypeScript
mono ./src/index.ts

# 使用本地包运行 Vite
mono ./node_modules/vite/bin/vite.js

3. （可选）添加 Vite 插件用于浏览器端

npm install -D vite-plugin-mono

// vite.config.ts import { defineConfig } from 'vite' import vue from '@vitejs/plugin-vue' import { viteMono } from 'vite-plugin-mono' export default defineConfig({
  plugins: [
    viteMono(),  // 放第一个！ vue()
  ]
})

特性

• 零侵入 - 无需重构项目，无需配置文件
• 自动发现 - 递归查找所有本地包
• 即时生效 - 修改立即生效
• 包管理器无关 - 支持 npm、yarn、pnpm、bun
• 零配置 - 默认 ./src/index.ts，可选 local 字段

工作原理

包发现

直线向上查找距离最远的项目根目录 (.idea/.vscode/.git/package.json)
  └── 递归扫描
      └── 查找所有 package.json
          └── 根据 "name" 字段注册

导入拦截

// 你的代码 import { utils } from 'my-utils' // Mono 重定向到源码 // → /path/to/my-utils/src/index.ts 

配置

零配置（默认）

所有包默认使用 ./src/index.ts。无需任何配置！

自定义入口（可选）

在 package.json 中添加 local 字段：

{ "name": "my-package", "local": "./src/main.ts" } 

环境要求

• Node.js >= 18.19.0
• ESM 项目 - package.json 中需要 "type": "module"