「实战指南」从零构建 Monorepo 工程化体系:TypeScript + ESLint + Prettier 全流程配置

TypeScript+ESLint+Vitest:构建现代前端工程化开发环境实战指南 在前端开发领域,代码质量和开发效率是衡量工程化水平的核心指标。通过静态类型检查、代码规范约束和自动化测试等技术手段,可以从源头预防运行时错误、统一团队协作风格并保障代码逻辑的健壮性。TypeScript作为JavaScript的超集,提供了强大的静态类型系统,能在编译阶段捕获类型错误;ESLint则通过可配置的规则集,对代码质量和风格进行实时检查与修复;而Vitest作为新一代测试框架,凭借其极速的热更新和原生ESM支持,让单元测试的编写与执行变得高效便捷。这三者协同工作,构成了前端开发阶段质量保障的核心闭 阅读详情

1. 为什么你的团队需要一个 Monorepo 工程化体系?

我见过太多团队在项目初期,为了快速上线,把代码规范、格式检查这些“基建”工作往后放。结果呢?三个月后,代码库变成了一个没人敢动的“屎山”——TypeScript 配置五花八门,ESLint 规则形同虚设,Prettier 格式化全靠手动。每次 Code Review 都像在玩“大家来找茬”,团队成员互相抱怨代码风格不统一,合并分支时冲突多到让人崩溃。

如果你也遇到过这些问题,那今天这篇文章就是为你准备的。我要带你从零开始,搭建一个真正能用、好用、团队爱用的 Monorepo 工程化体系。这不是那种只讲理论的教程,而是我踩过无数坑、在十几个实际项目中验证过的实战方案。

简单来说,我们要实现的目标是:在一个仓库里管理多个项目(比如前端应用、后端服务、共享组件库),同时保证所有代码都遵循统一的 TypeScript 类型检查、ESLint 代码规范和 Prettier 代码格式化。更重要的是,这个流程要自动化——代码提交前自动检查,不符合规范的根本提交不上去。

听起来很复杂?别担心,我会用最直白的方式,一步步带你实现。我们先从最基础的环境搭建开始。

2. 环境准备与项目初始化

2.1 工具选型:为什么是 pnpm?

在开始之前,我们先聊聊工具选择。市面上包管理器不少,为什么我强烈推荐 pnpm 来做 Monorepo?

我最早用 npm,后来换 yarn,最后锁定 pnpm,根本原因就两个字:效率。pnpm 的硬链接机制,让同样的依赖在磁盘上只存一份。你可能没概念这能省多少空间,我举个例子:我们团队有个项目,用 npm 安装后 node_modules 占了 2.3GB,换成 pnpm 后只有 800MB。更重要的是安装速度——pnpm 的依赖提升(hoisting)策略,让安装时间从原来的 5 分钟缩短到 1 分钟。

安装 pnpm 很简单,如果你已经装了 Node.js(建议 16.17 或更高版本),一行命令搞定:

npm install -g pnpm

安装完成后验证一下版本,确保是 7.0.0 或更高:

pnpm -v

2.2 创建项目骨架

现在我们来创建项目的基本结构。打开终端,执行以下命令:

# 创建项目目录
mkdir my-monorepo && cd my-monorepo

# 初始化根目录的 package.json
pnpm init

初始化时,你可以一路回车用默认值,或者按需修改。我建议把 name 改成带 scope 的形式,比如 @your-org/monorepo,这样更规范。

接下来是关键一步:创建 pnpm-workspace.yaml 文件。这个文件定义了哪些目录属于工作区(workspace),也就是哪些是我们要管理的子包。

# pnpm-workspace.yaml
packages:
  - 'packages/*'    # 所有共享包都放在这里
  - 'apps/*'        # 所有应用都放在这里
  - 'tools/*'       # 工具脚本可以放这里

这个配置告诉 pnpm:“嘿,packages、apps、tools 这三个目录下的每个子文件夹,都是一个独立的包,你要把它们当成一个整体来管理。”

现在创建目录结构:

# 创建核心目录
mkdir -p packages/core
mkdir -p packages/ui
mkdir -p apps/web-app
mkdir -p apps/admin-app
mkdir -p tools/scripts

你的项目结构现在应该是这样的:

my-monorepo/
├── package.json
├── pnpm-workspace.yaml
├── packages/
│   ├── core/      # 核心工具库
│   └── ui/        # UI 组件库
├── apps/
│   ├── web-app/   # 用户端应用
│   └── admin-app/ # 管理后台应用
└── tools/
    └── scripts/   # 构建脚本等工具

2.3 创建第一个子包

让我们先创建最基础的 core 包。进入 packages/core 目录:

cd packages/core
pnpm init

修改生成的 package.json,我建议你这样配置:

{
  "name": "@your-org/core",
  "version": "1.0.0",
  "description": "共享工具函数库",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "files": ["dist"],
  "scripts": {
    "build": "tsc",
    "dev": "tsc --watch"
  },
  "keywords": [],
  "author": "",
  "license": "MIT"
}

注意 name 字段,我用了 @your-org/core 这种带 scope 的命名。这样做有两个好处:一是避免和 npm 上的公共包重名,二是在代码中引用时一目了然,知道这是内部包。

用同样的方法,创建 ui 包和两个应用包。每个包的 package.json 都要根据实际用途调整。比如 apps/web-app 可能用 Vite 或 Next.js,那 scripts 里就要有 dev、build 等命令。

2.4 安装共享依赖

这是 pnpm workspace 的第一个魔法时刻。我们要在根目录安装 TypeScript,这样所有子包都能共享这个依赖。

回到项目根目录:

cd ../..  # 回到 my-monorepo 根目录
pnpm add typescript -D -w

注意 -w 参数,它代表 --workspace-root,意思是“把这个依赖安装在根目录”。如果不加 -w,pnpm 会报错提醒你——这是 pnpm 的贴心设计,防止你误操作。

安装完成后,你会在根目录的 package.json 里看到 TypeScript 出现在 devDependencies 中。但更重要的是,所有子包现在都能直接使用 TypeScript 了,不需要在每个子包里单独安装。

3. 配置统一的 TypeScript 环境

3.1 创建基础 TypeScript 配置

TypeScript 配置是 Monorepo 里最容易混乱的部分。每个团队可能都有自己的习惯,但经过多个项目实践,我总结出了一套“黄金配置”。

在根目录创建 tsconfig.base.json:

{
  "compilerOptions": {
    // 目标 ECMAScript 版本
    "target": "ES2020",
    
    // 模块系统
    "module": "ESNext",
    "moduleResolution": "Node",
    
    // 严格类型检查
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictBindCallApply": true,
    "strictPropertyInitialization": true,
    "noImplicitThis": true,
    "useUnknownInCatchVariables": true,
    "alwaysStrict": true,
    
    // 模块解析
    "baseUrl": ".",
    "paths": {
      "@your-org/*": ["packages/*/src"],
      "@apps/*": ["apps/*/src"]
    },
    
    // 互操作性
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "resolveJsonModule": tru
从零构建现代化TypeScript CLI工具:AI Agent开发的工程化实践 在软件开发领域,命令行界面(CLI)工具是开发者与系统交互的重要桥梁,其工程化水平直接影响开发效率和维护成本。通过静态类型检查、模块化设计和自动化构建等核心原理,现代CLI工具能够提供更可靠的代码质量和更流畅的开发体验。在AI Agent技术快速发展的背景下,一个健壮的工程基础对于集成复杂AI能力、实现可扩展的智能体框架具有关键价值。本文以TypeScript为核心技术栈,结合ESLint、Prettier、Vitest和Tsup等现代化工具链,详细演示如何搭建一个类型安全、测试完备、构建高效的CLI项目脚 阅读详情

相关推荐

Monorepo工程化模板搭建:pnpm workspace + TypeScript最佳实践

在软件工程中,代码仓库的管理方式直接决定团队协作效率与交付质量。当多个项目各自独立存放时,依赖发布烦琐、公共逻辑升级难以同步、代码共享方式混乱等问题会随规模扩大而愈发尖锐。Monorepo通过将多个子项目收归统一仓库,以单一锁文件与统一依赖治理从根源上减少重复劳动。其核心原理依赖包管理器的workspace机制——pnpm workspace利用内容寻址存储与严格依赖隔离,显著降低磁盘占用并避免幽灵依赖;TypeScript则通过共享tsconfig配置实现跨子包的统一类型检查。配合Turborepo构建编

weixin_34034670的博客 174

monorepo-eslint-prettier:具有纱线工作区,ESLint和Prettier的Monorepo游乐场

漂亮的单人房 一个带有纱线工作区,ESLint和Prettier的Monorepo游乐场。 发展历程 克隆仓库 $ git clone https://github.com/robertoachar/monorepo-eslint-prettier.git 安装依赖 $ yarn 运行脚本 行动 用法 开始开发 yarn start 皮棉代码 yarn lint 作者 执照

eslint-configs:eslint配置的Monorepo

自定义eslint配置 Monorepo提供可扩展的CONFIGS为 。 可用配置 当前,有3种可用配置: @ofadiman/eslint-config-base -通用这两个规则有效NodeJS和ReactJS发展。 @ofadiman/eslint-config-node -规则为特定NodeJS发展。 @ofadiman/eslint-config-react - ReactJS开发特定的规则。 安装 要安装其中一个配置,只需运行以下命令: npx install-peerdeeps eslint-config-base 这将安装配置本身及其所有依赖项。 用法 要使用已安装的配置,只需将其名称添加到eslint配置文件中的extends字段即可: module . exports = { extends : [ '@ofadiman/eslint-config-bas

eslint-plugin-monorepo:用于monorepos的ESLint插件

eslint-plugin-monorepo ESLint规则的集合,用于在monorepo中执行导入规则。 支持: 组态 使用"recommended"配置: // .eslintrc.json { " extends " : [ " plugin:monorepo/recommended " ] } 或手动启用规则: // .eslintrc.json { " plugins " : [ " monorepo " ], " rules " : { " monorepo/no-internal-import " : " error " , " monore

树莓派5外接RTX显卡:从PCIe到驱动的完整踩坑指南

在ARM架构与GPU加速的交汇点,树莓派5凭借其PCIe接口为DIY爱好者打开了外接独立显卡的大门。然而,PCIe x1的带宽限制、供电差异以及NVIDIA驱动在ARM Linux上的兼容性,使得这一组合成为一场高强度的系统底层排错训练。从理解PCIe总线原理、驱动加载机制到CUDA环境配置,每一步都充满挑战。本文以工程实践视角,梳理外接RTX显卡的完整流程、常见故障与性能瓶颈,并探讨其在边缘计算、AI推理等场景下的真实价值,帮助你理性评估这一实验性方案的可行性与替代路径。

chubaisheng8627的博客 353

全双工AI语音交互:从原理到实践,构建实时对话系统

语音交互技术正从传统的半双工模式向全双工模式演进,以实现更自然、实时的对话体验。全双工交互的核心原理在于模拟人类电话通话,允许双方同时发送和接收音频流,这需要流式语音识别(Streaming ASR)和实时自然语言理解(Real-time NLU)技术的深度整合。其技术价值在于显著降低交互延迟,支持智能打断(Barge-in),从而提升人机对话的流畅度和自然度。在应用场景上,全双工技术是智能助手、实时翻译、车载语音及无障碍交互等领域的关键突破。本文以微软MAI Realtime等模型为例,探讨如何利用开源技

weixin_33693070的博客 406

RISC-V内核移植实战:从零开始手把手实现RT-Thread上下文切换(附GD32VF103代码解析)

本文详细解析了在RISC-V架构上移植RT-Thread实时操作系统的核心步骤,重点聚焦于上下文切换机制的实现。通过对比ARM Cortex-M与RISC-V在中断处理和寄存器管理上的关键差异,并以GD32VF103开发板为例,手把手指导开发者完成libcpu抽象层适配、线程栈初始化以及三种上下文切换方式的代码编写与调试,为嵌入式开发者从ARM转向RISC-V平台提供了实战指南。

fern8的博客 740

【SPSS实战】手动实现Quade非参数协方差分析:从数据准备到结果解读

本文详细介绍了在SPSS中手动实现Quade非参数协方差分析的实战方法。当数据不满足正态分布等参数检验假设时,通过将协变量和因变量转换为秩,并利用秩回归残差进行Kruskal-Wallis组间比较,提供了一种清晰、可操作的近似解决方案。该方法有效解决了非正态数据的协变量调整问题,适用于实验研究和调查数据分析。

bean的博客 469

PX4 磁罗盘干扰分析

无人机上的电机电流会干扰无人机上搭载的磁罗盘,PX4官方提供了一些方式,通过分析飞行日志,判断电机是否对磁罗盘有严重影响。

Zecet的博客 3360

别再一个个BAPI调了!用CVI_EI_INBOUND_MAIN一次性搞定SAP BP主数据(附完整ABAP代码)

本文详细介绍了如何使用SAP标准函数CVI_EI_INBOUND_MAIN高效维护业务伙伴(BP)主数据,替代传统的多BAPI调用方式。通过完整ABAP代码示例,展示了如何一站式处理供应商、客户、公司代码等所有视图的创建与更新,提升数据一致性和开发效率。

weixin_29204205的博客 302

手把手教你学 MATLAB 实战训练(6.5):基础实战实例

MATLAB 是一款强大的数学软件,广泛应用于工程计算、信号处理、控制系统设计、图像处理等领域。学习 MATLAB 不仅可以提高你的编程技能,还能帮助你解决实际的数学和工程问题。下面我将通过几个实战训练实例来教你如何使用 MATLAB。

xiaoheshang_123的博客 369

【软考之软件设计师】学习笔记

interface 接口implements 实现接口(与接口配套使用)接口里要是有方法定义,子类就会实现。

云轩阁 2537

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

假人有限元模型

假人模型,车辆碰撞假人有限元模型,适合做乘员安全的研究者利用

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

上一篇: Win10打印机共享终极指南:绕过密码访问的本地安全策略配置
下一篇: WebSocket调试避坑指南:如何在Apifox中处理常见连接与消息问题
php55
博客等级 码龄15年 51粉丝 1553原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值