构建工具 on Liangweidong's blog

Vite 7 构建工具：从入门到 React / Vue / TypeScript 工程化实战

Tue, 15 Jul 2025 00:00:00 +0800

为什么写这篇：Vite 5+ 在 2023 年起成为新项目默认；Vite 6（2024-11）性能再次飞跃；Vite 7（2025-06）支持 Rolldown 实验性打包器。本文用最新 Vite 7 + React/Vue + TS 走通完整工程化流程，附带 monorepo 实战。

适用读者：要从 Webpack 迁到 Vite 的工程师；想给新项目选 Vite 的负责人；想用 Vite 7 最新特性（Rolldown / 环境变量）的中高级前端。

前置知识：会用 npm/pnpm；了解 React 或 Vue 基础；知道 TypeScript 是什么。

Vite 是什么
环境要求
创建 Vite 项目：5 种模板
项目结构详解
Vite 核心配置文件
TypeScript 集成
路径别名 @ 配置
反向代理与 HMR
多环境变量 .env 管理
生产构建：Rollup 与 Rolldown 实验
代码风格：ESLint + Prettier
VSCode 必装插件
Monorepo + pnpm workspace 实战
Vite vs Webpack 性能对比
常见排错

1. Vite 是什么

Vite（法语"快"的发音 /vit/）是下一代前端构建工具，由 Vue 作者尤雨溪团队开发。核心目标：让开发体验更快、更顺手。

1.1 核心特性

特性	说明
极速冷启动	开发模式不打包，按需 ESM 编译
毫秒级 HMR	修改文件只更新该模块，不重新加载页面
开箱即用 TS / JSX / CSS 预处理器	零配置支持
生产用 Rollup 打包	产物优化、Tree Shaking、代码分割
生态完整	Vue / React / Svelte / Solid / Preact 全支持
插件体系	兼容 Rollup 插件、自动兼容大多数 Webpack 插件

1.2 为什么快：传统 vs Vite

1
2
3
4
5
6
7


传统 Webpack 模式（dev）：
启动 ── 打包所有模块 ── 才能 serve

Vite 模式（dev）：
启动 ── 立即 serve ── 浏览器按需请求 ESM
 ↑
 浏览器原生 import 解析，服务器只编译被请求的文件

原理：现代浏览器都支持 <script type="module"> + 原生 ESM 导入。Vite 把"打包"这件事推迟到浏览器运行时——服务器只编译被请求的单个文件，完全跳过冷启动的全量打包。

2. 环境要求

工具	版本	备注
Node.js	20.19+ 或 22.12+	Vite 7 强制要求
pnpm（推荐）	9+	装包快、磁盘省
npm	10+	Node 自带
yarn	4+	Berry 系列

1
2


node -v # v20.19.0 或 v22.12.0+
pnpm -v # 9.x

不兼容旧 Node：Vite 7 不再支持 Node 18.x。

3. 创建 Vite 项目：5 种模板

3.1 命令行创建

1

pnpm create vite

交互式：

1
2
3
4
5


✔ Project name: … react-ts-demo1
✔ Select a framework: › React
✔ Select a variant: › TypeScript
✔ Use rolldown-vite (Experimental)?: no
✔ Install with pnpm and start now?: yes

跑完自动启动：

1
2
3
4
5


 VITE v7.2.7 ready in 339 ms

 ➜ Local: http://localhost:5173/
 ➜ Network: use --host to expose
 ➜ press h + enter to show help

3.2 直接指定模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# React + TS
pnpm create vite react-ts-demo --template react-ts

# Vue 3 + TS
pnpm create vite vue3-ts-demo --template vue-ts

# Svelte
pnpm create vite svelte-demo --template svelte-ts

# 原生 JS
pnpm create vite vanilla-demo --template vanilla

# 列出所有模板
pnpm create vite --help

3.3 Rolldown-Vite 实验性选项

Vite 7 实验性接入 Rolldown——基于 Rust 的下一代打包器，目标是替换 esbuild + Rollup，实现极致构建速度。

问：Use rolldown-vite (Experimental)?: no → 目前不建议生产用
实验性质，可能与某些插件不兼容
实际收益：5-10x 打包速度提升（仅生产模式）

4. 项目结构详解

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


react-ts-demo1/
├── dist/ # 构建产物
├── node_modules/
├── public/ # 不参与构建的静态资源
│ └── vite.svg
├── src/
│ ├── assets/ # 静态资源（被 webpack/vite 处理）
│ │ └── react.svg
│ ├── components/ # 公共组件
│ ├── App.tsx # 根组件
│ ├── main.tsx # 入口
│ ├── App.css
│ ├── index.css # 全局样式入口
│ └── vite-env.d.ts # Vite 内置类型
├── .gitignore
├── eslint.config.js # ESLint 9 扁平配置
├── index.html # 入口 HTML
├── package.json
├── pnpm-lock.yaml # 必须提交
├── README.md
├── tsconfig.app.json # 应用代码 TS 配置
├── tsconfig.json # TS 根配置
├── tsconfig.node.json # Node 环境 TS 配置
└── vite.config.ts # Vite 配置

tsconfig 拆三份：Vite 模板默认把 TS 配置拆成 tsconfig.app.json（业务代码）和 tsconfig.node.json（vite.config.ts），用 references 关联。

5. Vite 核心配置文件

vite.config.ts：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41


import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react-swc'
import path from 'path'

export default defineConfig({
 plugins: [react()],

 resolve: {
 alias: {
 '@': path.resolve(__dirname, 'src')
 }
 },

 server: {
 port: 8080,
 host: '127.0.0.1',
 open: true,
 proxy: {
 '/api': {
 target: 'http://localhost:3000',
 changeOrigin: true,
 rewrite: (p) => p.replace(/^\/api/, '')
 }
 }
 },

 build: {
 target: 'es2020',
 sourcemap: false,
 outDir: 'dist',
 rollupOptions: {
 output: {
 manualChunks: {
 react: ['react', 'react-dom'],
 router: ['react-router-dom'],
 ui: ['antd']
 }
 }
 }
 }
})

6. TypeScript 集成

Vite 自动支持 .ts / .tsx / .vue 文件——不需要 ts-loader / babel-loader。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


// vite-env.d.ts
/// <reference types="vite/client" />

interface ImportMetaEnv {
 readonly VITE_APP_TITLE: string
 readonly VITE_API_BASE: string
}

interface ImportMeta {
 readonly env: ImportMetaEnv
}

读环境变量：

1
2
3


console.log(import.meta.env.VITE_API_BASE)
console.log(import.meta.env.MODE) // 'development' | 'production'
console.log(import.meta.env.DEV) // boolean

7. 路径别名 @ 配置

7.1 vite.config.ts

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


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

export default defineConfig({
 resolve: {
 alias: {
 '@': path.resolve(__dirname, 'src')
 }
 }
})

7.2 tsconfig.json（必须配，否则 TS 找不到）

1
2
3
4
5
6
7
8


{
 "compilerOptions": {
 "baseUrl": ".",
 "paths": {
 "@/*": ["src/*"]
 }
 }
}

之后就能 import Foo from '@/components/Foo'。

8. 反向代理与 HMR

8.1 代理后端 API

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


server: {
 proxy: {
 '/api': {
 target: 'http://localhost:3000',
 changeOrigin: true,
 rewrite: (p) => p.replace(/^\/api/, '')
 },
 '/socket.io': {
 target: 'http://localhost:3000',
 ws: true, // 支持 WebSocket
 changeOrigin: true
 }
 }
}

8.2 HMR 配置

1
2
3
4
5
6
7


server: {
 hmr: {
 host: '127.0.0.1',
 port: 8080,
 overlay: true // 错误时全屏遮罩
 }
}

8.3 在 React 中接受 HMR

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// main.tsx
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import App from './App.tsx'

createRoot(document.getElementById('root')!).render(
 <StrictMode>
 <App />
 </StrictMode>
)

Vite 自动通过 import.meta.hot 注入 HMR API，不需要额外配置——React Fast Refresh 自动接管。

9. 多环境变量 .env 管理

Vite 默认只有 development 和 production。要扩展：

1
2
3
4


.env # 所有环境都加载
.env.development # npm run dev 加载
.env.test # npm run build --mode test 加载
.env.production # npm run build --mode production 加载

9.1 .env.development

1
2


VITE_APP_TITLE = '开发环境'
VITE_API_BASE = '/api'

9.2 .env.production

1
2


VITE_APP_TITLE = '生产环境'
VITE_API_BASE = 'https://api.example.com'

9.3 package.json scripts

1
2
3
4
5
6
7
8
9


{
 "scripts": {
 "dev": "vite",
 "build": "tsc -b && vite build",
 "build:test": "tsc --noEmit && vite build --mode test",
 "build:prod": "tsc --noEmit && vite build --mode production",
 "preview": "vite preview"
 }
}

必须 VITE_ 开头才能被 import.meta.env 识别——防止意外暴露服务端配置。

10. 生产构建：Rollup 与 Rolldown 实验

10.1 默认 Rollup 打包

1
2
3
4
5
6
7


pnpm build
# vite v7.2.7 building for production...
# ✓ 1234 modules transformed.
# dist/index.html 0.45 kB
# dist/assets/index-abc123.js 312.50 kB │ gzip: 102.40 kB
# dist/assets/index-def456.css 45.20 kB │ gzip: 12.10 kB
# ✓ built in 5.42s

10.2 关键选项

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


build: {
 target: 'es2020', // 目标浏览器
 outDir: 'dist',
 sourcemap: false, // 生产不开
 minify: 'esbuild', // 默认 esbuild，可换 terser
 cssCodeSplit: true, // CSS 拆分
 chunkSizeWarningLimit: 1500, // 块大小警告阈值
 rollupOptions: {
 output: {
 manualChunks: { /* 拆包 */ },
 entryFileNames: 'assets/[name].[hash].js',
 chunkFileNames: 'assets/[name].[hash].js',
 assetFileNames: 'assets/[name].[hash][extname]'
 }
 }
}

10.3 启用 Rolldown 实验

升级到 Vite 7 + 安装 Rolldown Vite：

1

pnpm add rolldown-vite -D

目前不建议生产用——某些插件还不兼容。

11. 代码风格：ESLint + Prettier

11.1 ESLint 9 扁平配置（vite create 自动生成）

eslint.config.js：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


import js from '@eslint/js'
import globals from 'globals'
import reactHooks from 'eslint-plugin-react-hooks'
import reactRefresh from 'eslint-plugin-react-refresh'
import tseslint from 'typescript-eslint'

export default tseslint.config(
 { ignores: ['dist'] },
 {
 extends: [js.configs.recommended, ...tseslint.configs.recommended],
 files: ['**/*.{ts,tsx}'],
 languageOptions: {
 ecmaVersion: 2020,
 globals: globals.browser
 },
 plugins: {
 'react-hooks': reactHooks,
 'react-refresh': reactRefresh
 },
 rules: {
 ...reactHooks.configs.recommended.rules,
 'react-refresh/only-export-components': 'warn'
 }
 }
)

11.2 Prettier

1

pnpm add -D prettier eslint-config-prettier

.prettierrc.json：

1
2
3
4
5
6
7
8


{
 "printWidth": 100,
 "tabWidth": 2,
 "semi": false,
 "singleQuote": true,
 "trailingComma": "all",
 "endOfLine": "auto"
}

12. VSCode 必装插件

插件	用途
ESLint	9+ 扁平配置支持
Prettier	自动格式化
TypeScript Vue Plugin (Volar)	Vue 3 + TS
ES7+ React/Redux snippets	React 代码片段
Tailwind CSS IntelliSense	Tailwind 类名补全
Path Intellisense	路径补全
Stylelint	CSS/Less/SCSS 检查

13. Monorepo + pnpm workspace 实战

13.1 pnpm-workspace.yaml

1
2
3


packages:
 - 'apps/*'
 - 'packages/*'

13.2 apps/web/package.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


{
 "name": "@myorg/web",
 "private": true,
 "scripts": {
 "dev": "vite",
 "build": "tsc -b && vite build"
 },
 "dependencies": {
 "@myorg/utils": "workspace:*",
 "@myorg/ui": "workspace:*"
 }
}

13.3 packages/utils/package.json

1
2
3
4
5
6
7
8
9


{
 "name": "@myorg/utils",
 "version": "1.0.0",
 "type": "module",
 "main": "./src/index.ts",
 "exports": {
 ".": "./src/index.ts"
 }
}

13.4 跨包引用

1
2
3


// apps/web/src/App.tsx
import { formatDate } from '@myorg/utils'
import { Button } from '@myorg/ui'

1
2
3


pnpm install # 装所有工作区依赖 + 链接
pnpm -F @myorg/web dev # 只跑 web 包的 dev
pnpm -r build # 所有包 build

14. Vite vs Webpack 性能对比

维度	Vite 7	Webpack 5
冷启动	< 1s（按需编译）	10-30s（全量打包）
HMR 速度	< 100ms	1-5s
生产构建	Rollup，5-15s	30s-2min
配置复杂度	零配置 + 少量 plugins	大量 loader + plugin
生态兼容	Rollup 插件 + 大量 Vite 插件	Webpack 生态（成熟）
SSR 支持	强（Vite SSR API）	中（webpack-ssr-plugin）
学习曲线	平缓	陡峭

2025 选型：

新项目：直接 Vite（启动快、配置简单）

老 Webpack 项目：不必强迁——Webpack 5 + 持久化缓存已经够快

大厂 monorepo：评估 Rspack（Rust 编写、Webpack 兼容 API）—— 字节跳动 + Microsoft 在用

15. 常见排错

15.1 TS2307: Cannot find module ‘./App.vue’

解法：建 src/vite-env.d.ts（Vite 模板已自动生成）：

1
2
3
4
5
6


/// <reference types="vite/client" />
declare module '*.vue' {
 import type { DefineComponent } from 'vue'
 const component: DefineComponent<{}, {}, any>
 export default component
}

15.2 import path 找不到

检查清单：

vite.config.ts 配了 alias
tsconfig.json 配了 paths（两端必须都配）
重启 VSCode（让 TS 服务重读 tsconfig）

15.3 代理 404

1
2
3
4
5
6
7


proxy: {
 '/api': {
 target: 'http://localhost:3000',
 changeOrigin: true,
 // rewrite: (p) => p.replace(/^\/api/, '') // ⚠️ 注释掉，看后端路由
 }
}

先看 dev server 真正发到哪——加 bypass: (req) => req.url 在 proxy 里打印。

15.4 端口被占用

1
2
3
4
5
6
7


# Windows
netstat -ano | findstr :8080
taskkill /PID <pid> /F

# macOS / Linux
lsof -i :8080
kill -9 <pid>

或改 Vite 配置：

1
2
3
4


server: {
 port: 8081, // 换个端口
 strictPort: false // 端口被占时自动换
}

小结

Vite 7 是 2025 年前端构建工具的"事实标准"：

极快冷启动（< 1s）—— 跳过 dev 模式的全量打包
TypeScript / JSX / CSS 预处理器零配置
@ 路径别名两行配置
多环境变量 .env.development / .env.production
生产 Rollup 打包，可选 Rolldown 实验（更快）
monorepo 配合 pnpm workspace 一行 pnpm -r build 跑所有包

下一步：学 Vite 插件开发（写自己的 plugin）、Vite SSR（配合 React 19 RSC / Vue 3 Nuxt）、微前端（Vite + Module Federation）。

参考资料

Maven 全套实战：从安装到多模块企业级构建

Thu, 20 Feb 2014 00:00:00 +0800

Maven 全套实战：从安装到多模块企业级构建

背景与价值

Maven 是 Java 生态事实标准构建工具（Ant 已老、Gradle 学习成本高）。核心价值：

依赖管理：自动下载 jar 及其传递依赖，避免版本冲突
标准化结构：src/main/java、src/test/java 等约定优于配置
多模块管理：父子 POM 继承 + dependencyManagement 统一版本
构建生命周期：compile / test / package / install / deploy 一键式

本文按"安装 → 核心配置 → 多模块 → 实战坑"完整路径展开，基于 Maven 3.9.x 实测。

安装与配置

1. 下载解压

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# Linux
curl -O https://archive.apache.org/dist/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz
mkdir -p /opt/maven
tar -zxvf apache-maven-3.9.6-bin.tar.gz -C /opt/maven

# 配置环境变量
export JAVA_HOME=/opt/java/jdk1.8.0_381
export MAVEN_HOME=/opt/maven
export PATH=.:$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$MAVEN_HOME/bin:$PATH

# 验证
mvn -version
# Apache Maven 3.9.6 (8c8575b0e1b8...)
# Java version: 1.8.0_381

2. 全局配置文件 `${maven_home}/conf/settings.xml`

settings.xml 集中管理仓库镜像、代理、profile、服务器认证等全局配置，避免每个项目单独配。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56


<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0">

 <!-- 本地仓库路径（默认 ${user.home}/.m2/repository） -->
 <!--<localRepository>/path/to/local/repo</localRepository>-->

 <!-- 离线模式（无法联网时） -->
 <!--<offline>false</offline>-->

 <!-- 代理（公司内网访问外网 Maven 中央仓库时） -->
 <proxies>
 <proxy>
 <id>myproxy</id>
 <active>true</active>
 <protocol>http</protocol>
 <host>proxy.example.com</host>
 <port>8080</port>
 <username>proxyuser</username>
 <password>{{PROXY_PASSWORD}}</password>
 <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
 </proxy>
 </proxies>

 <!-- 服务器认证（部署到 Nexus / 私库时用） -->
 <servers>
 <server>
 <id>nexus-releases</id>
 <username>{{NEXUS_USER}}</username>
 <password>{{NEXUS_PASSWORD}}</password>
 </server>
 </servers>

 <!-- 镜像（关键：阿里云加速国内下载） -->
 <mirrors>
 <mirror>
 <id>aliyun-public</id>
 <name>阿里云 Maven 公共仓库</name>
 <url>https://maven.aliyun.com/repository/public</url>
 <mirrorOf>central</mirrorOf>
 </mirror>
 </mirrors>

 <!-- 多环境 Profile -->
 <profiles>
 <profile>
 <id>jdk-1.8</id>
 <activation>
 <activeByDefault>true</activeByDefault>
 </activation>
 <properties>
 <maven.compiler.source>1.8</maven.compiler.source>
 <maven.compiler.target>1.8</maven.compiler.target>
 </properties>
 </profile>
 </profiles>
</settings>

3. 阿里云镜像配置（关键）

国内访问 Maven 中央仓库（repo1.maven.org）经常超时，建议配置阿里云镜像：

仓库类型	阿里云地址
公共仓库	`https://maven.aliyun.com/repository/public`
Google	`https://maven.aliyun.com/repository/google`
Spring	`https://maven.aliyun.com/repository/spring`
Apache Snapshots	`https://maven.aliyun.com/repository/apache-snapshots`

配置示例（settings.xml 镜像）：

1
2
3
4
5
6


<mirror>
 <id>aliyun-spring</id>
 <name>阿里云 Spring 仓库</name>
 <url>https://maven.aliyun.com/repository/spring</url>
 <mirrorOf>spring-milestones,spring-snapshots</mirrorOf>
</mirror>

核心概念

1. 坐标（GAV）

每个 Maven 构件由三要素唯一定位：

1
2
3
4
5


<dependency>
 <groupId>org.springframework.boot</groupId> <!-- 组织 -->
 <artifactId>spring-boot-starter-web</artifactId> <!-- 项目 -->
 <version>3.2.0</version> <!-- 版本 -->
</dependency>

2. 仓库类型

类型	位置	用途
本地仓库	`~/.m2/repository/`	已下载的依赖
中央仓库	`repo1.maven.org`	Maven 官方仓库（默认）
私服	Nexus / Artifactory	公司内网，缓存 + 部署
镜像仓库	阿里云 / 华为云	中央仓库的国内镜像

3. 依赖范围（Scope）

Scope	编译	测试	运行时	例子
`compile`（默认）	✅	✅	✅	`spring-core`
`provided`	✅	✅	❌	`servlet-api`（容器提供）
`runtime`	❌	✅	✅	`JDBC 驱动`
`test`	❌	✅	❌	`JUnit`
`system`	✅	✅	❌	引用本地 jar（不推荐）

4. 生命周期阶段

1
2
3
4
5
6


mvn clean # 清理 target/
mvn compile # 编译 main
mvn test # 编译并运行测试
mvn package # 打包成 jar/war
mvn install # 安装到本地仓库（供其他模块引用）
mvn deploy # 部署到远程私服

多模块项目（企业级核心）

1. 父 POM 约定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


my-project/ # 父项目根目录
├── pom.xml # 父 POM（packaging=pom）
├── my-app/ # 主应用模块
│ ├── pom.xml
│ └── src/
├── my-common/ # 公共工具模块
│ ├── pom.xml
│ └── src/
└── my-api/ # API 定义模块
 ├── pom.xml
 └── src/

2. 父 POM 完整模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97


<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0">
 <modelVersion>4.0.0</modelVersion>

 <!-- 继承 Spring Boot Starter Parent（统一版本管理） -->
 <parent>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-parent</artifactId>
 <version>2.6.14</version>
 <relativePath/>
 </parent>

 <groupId>com.example</groupId>
 <artifactId>my-project</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 <packaging>pom</packaging>
 <name>my-project</name>

 <!-- 子模块清单 -->
 <modules>
 <module>my-common</module>
 <module>my-api</module>
 <module>my-app</module>
 </modules>

 <!-- 统一版本管理（子模块引用时不需要写版本号） -->
 <dependencyManagement>
 <dependencies>
 <!-- Spring Cloud -->
 <dependency>
 <groupId>org.springframework.cloud</groupId>
 <artifactId>spring-cloud-dependencies</artifactId>
 <version>${spring-cloud.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <!-- Spring Cloud Alibaba -->
 <dependency>
 <groupId>com.alibaba.cloud</groupId>
 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
 <version>${spring-cloud-alibaba.version}</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <!-- 项目内部模块 -->
 <dependency>
 <groupId>com.example</groupId>
 <artifactId>my-common</artifactId>
 <version>${project.version}</version>
 </dependency>
 </dependencies>
 </dependencyManagement>

 <!-- 公共依赖（所有子模块都会继承） -->
 <dependencies>
 <dependency>
 <groupId>org.projectlombok</groupId>
 <artifactId>lombok</artifactId>
 <scope>provided</scope>
 </dependency>
 </dependencies>

 <!-- 统一属性 -->
 <properties>
 <java.version>1.8</java.version>
 <maven.compiler.source>${java.version}</maven.compiler.source>
 <maven.compiler.target>${java.version}</maven.compiler.target>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 <spring-cloud.version>2021.0.1</spring-cloud.version>
 <spring-cloud-alibaba.version>2021.0.1.0</spring-cloud-alibaba.version>
 </properties>

 <!-- 多环境 Profile -->
 <profiles>
 <profile>
 <id>dev</id>
 <activation>
 <activeByDefault>true</activeByDefault>
 </activation>
 <properties>
 <profile.name>dev</profile.name>
 </properties>
 </profile>
 <profile>
 <id>test</id>
 <properties>
 <profile.name>test</profile.name>
 </properties>
 </profile>
 <profile>
 <id>prod</id>
 <properties>
 <profile.name>prod</profile.name>
 </properties>
 </profile>
 </profiles>
</project>

3. 子模块 POM

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


<?xml version="1.0" encoding="UTF-8"?>
<project>
 <parent>
 <groupId>com.example</groupId>
 <artifactId>my-project</artifactId>
 <version>1.0.0-SNAPSHOT</version>
 </parent>

 <artifactId>my-app</artifactId>
 <packaging>jar</packaging>

 <!-- 不需要写版本号（父 dependencyManagement 已管理） -->
 <dependencies>
 <dependency>
 <groupId>com.example</groupId>
 <artifactId>my-common</artifactId>
 </dependency>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
 </dependency>
 </dependencies>
</project>

常用命令

命令	作用
`mvn clean`	清理 target 目录
`mvn compile`	编译主代码
`mvn test`	运行单元测试
`mvn package -DskipTests`	打包跳过测试
`mvn dependency:tree`	树形展示依赖
`mvn dependency:tree -Dincludes=commons-logging`	过滤特定依赖
`mvn help:effective-pom`	查看完整 POM（合并父子）
`mvn -Pprod clean package`	激活 prod profile 打包
`mvn -pl my-app -am package`	只构建 my-app 及其依赖模块

实战坑

1. 依赖冲突（`NoClassDefFoundError` / `NoSuchMethodError`）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 查看依赖树
mvn dependency:tree -Dverbose

# 排除传递依赖
<dependency>
 <groupId>com.example</groupId>
 <artifactId>my-lib</artifactId>
 <exclusions>
 <exclusion>
 <groupId>commons-logging</groupId>
 <artifactId>commons-logging</artifactId>
 </exclusion>
 </exclusions>
</dependency>

2. JAR 包冲突定位

1
2
3
4
5
6


# 找哪个 jar 引入的
mvn dependency:tree -Dincludes=com.google.guava:guava

# 输出：
# [INFO] +- com.example:my-lib:jar:1.0:compile
# [INFO] | \- com.google.guava:guava:jar:30.0-jre:compile ← 这里

3. SNAPSHOT 版本不稳定

1.0.0-SNAPSHOT 表示"开发中快照"，Maven 默认每次构建都拉取最新。生产环境应锁定 release 版本。

4. `mvn package` 跳过测试

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 方式 1：命令行参数
mvn package -DskipTests

# 方式 2：surefire 插件配置
<plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-surefire-plugin</artifactId>
 <configuration>
 <skipTests>true</skipTests>
 </configuration>
</plugin>

5. 配置中心化 vs 分散

统一管理：父 POM dependencyManagement 集中版本
覆盖：子模块可显式覆盖（极少数情况）
避免：每个子模块独立写版本号（升级时全项目都要改）

Maven Wrapper（推荐）

mvnw 是项目自带的 Maven 包装脚本，避免开发者本地 Maven 版本不一致：

1
2
3
4
5
6
7
8
9


# 生成 wrapper（项目根目录执行一次）
mvn -N io.takari:maven:0.7.7:wrapper -Dmaven=3.9.6

# 提交到 Git
git add mvnw mvnw.cmd .mvn/
git commit -m "build: 添加 Maven Wrapper"

# 团队成员执行（无需安装 Maven）
./mvnw clean package

私服搭建（Nexus 3.x）

1
2
3
4
5
6


# Docker 一键启动
docker run -d \
 -p 8081:8081 \
 -v /data/nexus-data:/nexus-data \
 --name nexus \
 sonatype/nexus3:3.64.0

部署到 Nexus：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


<!-- 项目 pom.xml -->
<distributionManagement>
 <repository>
 <id>nexus-releases</id> <!-- 对应 settings.xml server id -->
 <url>http://{{NEXUS_HOST}}:8081/repository/maven-releases/</url>
 </repository>
 <snapshotRepository>
 <id>nexus-snapshots</id>
 <url>http://{{NEXUS_HOST}}:8081/repository/maven-snapshots/</url>
 </snapshotRepository>
</distributionManagement>

<build>
 <plugins>
 <plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-deploy-plugin</artifactId>
 </plugin>
 </plugins>
</build>

1

mvn deploy # 部署到 Nexus

前置知识与下一步

前置：

Java 基础语法、IDE 使用
基本的命令行操作
了解 Spring Boot 项目结构

下一步：

复杂构建用 Maven Profile + Resource Filtering 实现多环境打包
配合 Dockerfile + CI/CD 一键出镜像
巨型项目切分用 Maven 多仓库 + 微服务，避免单仓库超大

小结

Maven 3.9 + 阿里云镜像 + 标准 settings.xml 是企业 Java 项目的"开箱即用"组合。多模块项目靠父 POM dependencyManagement 统一版本 + 子 POM 引用简化，是避免"依赖版本地狱"的关键。Maven Wrapper 解决了团队成员本地 Maven 版本不一致的痛点。Nexus 私服是企业内网依赖缓存 + 内部 jar 部署的标配。

2024+ 视角：Maven 4 预览 + Gradle 8 对比

Maven 4.0 关键变化（2024 仍在预发布）

POM 结构化：XML → 仍是 XML，但解析器重写（Lexical 三遍解析），速度 +30%
多语言项目支持：原 Maven 只管 Java，Maven 4 开始支持 JS / Python / Rust 子项目
dependencyManagement 路径表达式：支持 ${groupId:artifactId:type:version} 直接引用父项目
CI 集成深度增强：mvn verify 输出 SBOM（软件物料清单）——合规审计直接用
MVN Daemon（实验）：常驻进程 + 增量编译，类似 Gradle Daemon

Maven 4 升级路径

1
2
3
4
5
6
7
8


<!-- pom.xml 顶部 -->
<project xmlns="http://maven.apache.org/POM/4.0.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 ...
</project>

主要差异：

POM modelVersion 不变（仍是 4.0.0）
升级命令：mvn -P maven-4-upgrade verify（Maven 4 自带）
大部分插件需升级到 4.x 版本

Gradle 8.x 与 Maven 4 的 2024+ 对比

维度	Maven 4	Gradle 8.x
构建速度	较慢（提升 30%）	快 2-10 倍（增量 + 守护进程）
配置语言	XML	Kotlin DSL / Groovy
增量构建	需 mvn incremental	原生支持
多语言	实验	Kotlin Multiplatform / Android
生态稳定性	25 年沉淀，文档全	较新，插件质量参差
学习曲线	低（约定优于配置）	中（DSL 学习）
企业 Java 占比	70%+	15%

选型建议：

新项目（Kotlin / Android / 复杂构建）：Gradle 8.x
传统 Spring / 金融 / 政府：Maven 仍是首选——团队上手快、CI 配置简单
Kotlin Multiplatform / 跨平台：必须 Gradle

镜像配置的 2024+ 演进

阿里云 2023 年起对 Maven 中央仓库做了全量同步，但 2024 之后新增了：

华为云镜像：https://repo.huaweicloud.com/repository/maven/
腾讯云镜像：https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
中国移动云镜像：https://mirrors.cmecloud.cn/repository/maven/

1
2
3
4
5
6
7


<mirrors>
 <mirror>
 <id>huawei-cloud</id>
 <url>https://repo.huaweicloud.com/repository/maven/</url>
 <mirrorOf>central</mirrorOf>
 </mirror>
</mirrors>

`dependencyManagement` 2024+ 进阶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


<!-- BOM 引用（Bill of Materials）-->
<dependencyManagement>
 <dependencies>
 <dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-dependencies</artifactId>
 <version>3.4.0</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 <dependency>
 <groupId>com.alibaba.cloud</groupId>
 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
 <version>2023.0.1.0</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 </dependencies>
</dependencyManagement>

Maven Wrapper 的 2024+ 变化

1
2
3
4
5


# 旧版（Takari wrapper）
mvn -N io.takari:maven:0.7.7:wrapper -Dmaven=3.9.6

# 新版（Maven 官方 wrapper 3.2+）
mvn wrapper:wrapper -Dmaven=3.9.9

新版 wrapper 由 Maven 官方维护，不需要 Takari 仓库。

依赖冲突排查的 2024+ 新工具

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 1. mvn dependency:tree（老牌）
mvn dependency:tree -Dverbose -Dincludes=commons-logging:commons-logging

# 2. maven-dependency-plugin 3.6+：dependency:analyze
mvn dependency:analyze

# 3. Enforcer 插件：禁止某些依赖
<plugin>
 <groupId>org.apache.maven.plugins</groupId>
 <artifactId>maven-enforcer-plugin</artifactId>
 <version>3.4.1</version>
</plugin>

实战坑（2024+）

Spring Boot 3.x 必须 JDK 17+——Maven 3.8.x 之前的版本不支持 --add-opens，需用 3.9.x
Maven Central 在 2024-06 调整了 HTTPS 证书链——老 Maven 版本（< 3.6.3）需升级
Nexus 3.64+ 强制 HTTPS——HTTP 私服要升级或保留 HTTP 白名单
JCenter 2022 已停止服务——所有 jcenter() 引用要改 mavenCentral()

2024+ 推荐组合

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


企业 Java 项目（Spring Boot 3.x）
├── Maven 3.9.x / Maven 4.0（2024+）
├── 阿里云镜像 + settings.xml
├── Maven Wrapper 3.2+
├── spring-boot-starter-parent 3.4.x
├── spring-cloud-dependencies 2024.0.x BOM
├── spring-cloud-alibaba-dependencies 2023.0.x BOM
├── 父 POM dependencyManagement 统一版本
├── 子 POM 引用无版本号
├── Nexus 3.64+ 私服（maven-releases + maven-snapshots）
└── mvn -Pprod clean package + Jib 打 Docker 镜像

构建工具 on Liangweidong's blog

Vite 7 构建工具：从入门到 React / Vue / TypeScript 工程化实战

目录

1. Vite 是什么

1.1 核心特性

1.2 为什么快：传统 vs Vite

2. 环境要求

3. 创建 Vite 项目：5 种模板

3.1 命令行创建

3.2 直接指定模板

3.3 Rolldown-Vite 实验性选项

4. 项目结构详解

5. Vite 核心配置文件

6. TypeScript 集成

7. 路径别名 @ 配置

7.1 vite.config.ts

7.2 tsconfig.json（必须配，否则 TS 找不到）

8. 反向代理与 HMR

8.1 代理后端 API

8.2 HMR 配置

8.3 在 React 中接受 HMR

9. 多环境变量 .env 管理

9.1 .env.development

9.2 .env.production

9.3 package.json scripts

10. 生产构建：Rollup 与 Rolldown 实验

10.1 默认 Rollup 打包

10.2 关键选项

10.3 启用 Rolldown 实验

11. 代码风格：ESLint + Prettier

11.1 ESLint 9 扁平配置（vite create 自动生成）

11.2 Prettier

12. VSCode 必装插件

13. Monorepo + pnpm workspace 实战

13.1 pnpm-workspace.yaml

13.2 apps/web/package.json

13.3 packages/utils/package.json

13.4 跨包引用

14. Vite vs Webpack 性能对比

15. 常见排错

15.1 TS2307: Cannot find module ‘./App.vue’

15.2 import path 找不到

15.3 代理 404

15.4 端口被占用

小结

参考资料

Maven 全套实战：从安装到多模块企业级构建

Maven 全套实战：从安装到多模块企业级构建

背景与价值

安装与配置

1. 下载解压

2. 全局配置文件 ${maven_home}/conf/settings.xml

3. 阿里云镜像配置（关键）

核心概念

1. 坐标（GAV）

2. 仓库类型

3. 依赖范围（Scope）

4. 生命周期阶段

多模块项目（企业级核心）

1. 父 POM 约定

2. 父 POM 完整模板

3. 子模块 POM

常用命令

实战坑

1. 依赖冲突（NoClassDefFoundError / NoSuchMethodError）

2. JAR 包冲突定位

3. SNAPSHOT 版本不稳定

4. mvn package 跳过测试

5. 配置中心化 vs 分散

Maven Wrapper（推荐）

私服搭建（Nexus 3.x）

前置知识与下一步

小结

2024+ 视角：Maven 4 预览 + Gradle 8 对比

Maven 4.0 关键变化（2024 仍在预发布）

Maven 4 升级路径

Gradle 8.x 与 Maven 4 的 2024+ 对比

镜像配置的 2024+ 演进

dependencyManagement 2024+ 进阶

Maven Wrapper 的 2024+ 变化

2. 全局配置文件 `${maven_home}/conf/settings.xml`

1. 依赖冲突（`NoClassDefFoundError` / `NoSuchMethodError`）

4. `mvn package` 跳过测试

`dependencyManagement` 2024+ 进阶