
Next.js 15 giới thiệu Turbopack làm bundler mặc định cho môi trường phát triển, với tùy chọn bật cho các bản dựng production. Sự thay đổi này hứa hẹn mang lại hiệu suất vượt trội, đặc biệt đối với các ứng dụng quy mô lớn và monorepo. Phân tích này cung cấp một so sánh thực nghiệm giữa Turbopack và Webpack trong môi trường monorepo Next.js mô phỏng 10.000 module, tập trung vào các chỉ số phát triển và production quan trọng.
Để đảm bảo một kịch bản doanh nghiệp thực tế, chúng tôi đã xây dựng một monorepo với các đặc điểm sau:
Chúng tôi đã sử dụng một script để tạo ra một số lượng lớn các module và ứng dụng giả để mô phỏng số lượng module và các phụ thuộc lẫn nhau.
import * as fs from 'fs';
import * as path from 'path';
const NUM_APPS = 50;
const MODULES_PER_APP = 200;
const SHARED_MODULES_DIR = path.join(__dirname, '../packages/shared-utils');
const APPS_DIR = path.join(__dirname, '../apps');
// Ensure directories exist
fs.mkdirSync(SHARED_MODULES_DIR, { recursive: true });
fs.mkdirSync(APPS_DIR, { recursive: true });
// Generate shared utility modules
for (let i = 0; i < MODULES_PER_APP; i++) {
const modulePath = path.join(SHARED_MODULES_DIR, `util${i}.ts`);
fs.writeFileSync(modulePath, `export const util${i} = () => 'Shared utility ${i}';\n`);
}
// Generate applications
for (let i = 0; i < NUM_APPS; i++) {
const appDir = path.join(APPS_DIR, `app${i}`);
fs.mkdirSync(appDir, { recursive: true });
// Create package.json
fs.writeFileSync(path.join(appDir, 'package.json'), JSON.stringify({
name: `app${i}`,
version: '1.0.0',
private: true,
scripts: {
dev: 'next dev',
build: 'next build',
start: 'next start',
},
dependencies: {
'react': '18.3.1',
'react-dom': '18.3.1',
'next': '15.0.0-rc.0',
// Simulate other common dependencies
'lodash': '^4.17.21',
'zustand': '^4.5.2',
'swr': '^2.2.5',
'sass': '^1.77.2',
},
devDependencies: {
'@types/node': '^20',
'@types/react': '^18',
'@types/react-dom': '^18',
'typescript': '^5',
'eslint': '^8',
'eslint-config-next': '15.0.0-rc.0',
'@svgr/webpack': '^8.1.0', // For SVGR
},
}, null, 2));
// Create next.config.mjs
fs.writeFileSync(path.join(appDir, 'next.config.mjs'), `
import path from 'path';
/** @type {import('next').NextConfig} */
const nextConfig = {
webpack: (config, { isServer }) => {
// Custom Babel plugin integration (example)
config.module.rules.push({
test: /\\.tsx?$/,
exclude: /node_modules/,
use: [
{
loader: 'babel-loader',
options: {
presets: ['next/babel'],
plugins: [
// Example: a custom Babel plugin for i18n
path.resolve(__dirname, '../../plugins/babel-i18n-plugin.js'),
],
},
},
],
});
// SVGR integration
config.module.rules.push({
test: /\\.svg$/,
use: ['@svgr/webpack'],
});
// Custom Webpack loader for YAML (example)
config.module.rules.push({
test: /\\.yaml$/,
use: 'yaml-loader', // Requires 'yaml-loader' package
});
// Ensure shared utilities are transpiled
config.module.rules.push({
test: /\\.tsx?$/,
include: [path.resolve(__dirname, '../../packages/shared-utils')],
use: {
loader: 'babel-loader',
options: {
presets: ['next/babel'],
},
},
});
return config;
},
};
export default nextConfig;
`);
// Create tsconfig.json
fs.writeFileSync(path.join(appDir, 'tsconfig.json'), JSON.stringify({
compilerOptions: {
lib: ['dom', 'dom.iterable', 'esnext'],
allowJs: true,
skipLibCheck: true,
strict: true,
noEmit: true,
esModuleInterop: true,
module: 'esnext',
moduleResolution: 'bundler',
resolveJsonModule: true,
isolatedModules: true,
jsx: 'preserve',
incremental: true,
plugins: [{ name: 'next' }],
paths: {
"@shared-utils/*": ["../../packages/shared-utils/*"]
}
},
include: ['next-env.d.ts', '**/*.ts', '**/*.tsx', '.next/types/**/*.ts', '../../packages/shared-utils/**/*.ts'],
exclude: ['node_modules'],
}, null, 2));
// Create next-env.d.ts
fs.writeFileSync(path.join(appDir, 'next-env.d.ts'), `/// <reference types="next" />\n/// <reference types="next/image-types/global" />\n`);
// Create pages/index.tsx
const imports = Array.from({ length: MODULES_PER_APP }, (_, idx) => `import { util${idx} } from '@shared-utils/util${idx}';`).join('\n');
const calls = Array.from({ length: MODULES_PER_APP }, (_, idx) => ` <p>{util${idx}()}</p>`).join('\n');
fs.writeFileSync(path.join(appDir, 'pages/index.tsx'), `
import Head from 'next/head';
${imports}
export default function Home() {
return (
<div>
<Head>
<title>App ${i}</title>
</Head>
<main>
<h1>Welcome to App ${i}!</h1>
${calls}
</main>
</div>
);
}
`);
}
// Create a dummy Babel plugin
fs.mkdirSync(path.join(__dirname, '../plugins'), { recursive: true });
fs.writeFileSync(path.join(__dirname, '../plugins/babel-i18n-plugin.js'), `
module.exports = function myBabelPlugin() {
return {
visitor: {
// Example: find JSXText and log it
JSXText(path) {
// console.log('Found JSXText:', path.node.value.trim());
},
},
};
};
`);
console.log('Monorepo simulation generated successfully.');
Script này tạo ra NUM_APPS ứng dụng Next.js, mỗi ứng dụng phụ thuộc vào MODULES_PER_APP module tiện ích dùng chung. Mỗi next.config.mjs được cấu hình để bao gồm một plugin Babel tùy chỉnh, SVGR và một Webpack loader tùy chỉnh, mô phỏng độ phức tạp trong thế giới thực.
Đối với mỗi chỉ số, chúng tôi đã thực hiện 5 lần chạy lạnh (cold run) và 10 lần chạy nóng (warm run), loại bỏ lần chạy đầu tiên để tính đến các hiệu ứng bộ nhớ đệm cấp hệ điều hành. Độ trễ P95 được tính cho HMR. Việc sử dụng RAM được đo bằng các lệnh ps aux và top, tính trung bình mức sử dụng cao nhất trong các hoạt động tương ứng.
next dev đến thông báo "ready on".next build đến khi hoàn thành.| Chỉ số | Webpack (Next.js 14) | Turbopack (Next.js 15 Dev) | Turbopack (Next.js 15 Prod) | Cải thiện (Dev so với Webpack) | Cải thiện (Prod so với Webpack) |
|---|---|---|---|---|---|
| Khởi động Dev lạnh (s) | 48.2 | 8.7 | N/A | 81.9% | N/A |
| Độ trễ HMR (ms, p95) | 1250 | 85 | N/A | 93.2% | N/A |
| Thời gian Build Prod (s) | 185.6 | N/A | 72.1 | N/A | 61.1% |
| RAM Dev (MB, Đỉnh) | 3800 | 1100 | N/A | 71.0% | N/A |
| RAM Prod (MB, Đỉnh) | 4500 | N/A | 1800 | N/A | 60.0% |
Việc di chuyển một ứng dụng Next.js phức tạp từ Webpack sang Turbopack, đặc biệt trong một monorepo, liên quan đến một số cân nhắc chính. Next.js 15 hướng tới khả năng tương thích cao, nhưng các cấu hình tùy chỉnh thường yêu cầu điều chỉnh.
Turbopack không sử dụng Babel để chuyển đổi mã theo mặc định. Nó tận dụng SWC (Speedy Web Compiler), cũng được viết bằng Rust. Nếu dự án của bạn dựa vào các plugin Babel tùy chỉnh cho các phép biến đổi AST cụ thể (ví dụ: trích xuất i18n, biến đổi cú pháp tùy chỉnh, loại bỏ mã chết dựa trên biến môi trường), chúng sẽ không thực thi trong pipeline SWC mặc định của Turbopack.
Vấn đề: Plugin Babel tùy chỉnh của bạn âm thầm không chạy, dẫn đến thiếu các phép biến đổi hoặc lỗi thời gian chạy.
Cách khắc phục:
// next.config.mjs
import path from 'path';
/** @type {import('next').NextConfig} */
const nextConfig = {
experimental: {
// Enable Turbopack for production builds (optional, but recommended for full benefits)
// turbopack: true,
},
webpack: (config, { isServer, dev, nextRuntime }) => {
// Only apply Babel fallback in development if Turbopack is active
if (dev && process.env.NEXT_WEBPACK_OPT_OUT_TURBOPACK !== '1') {
// Find the existing rule for JS/TS files
const jsRule = config.module.rules.find(
(rule) => rule.test && rule.test.toString().includes('tsx|ts|js|mjs|jsx')
);
if (jsRule) {
// Modify the existing rule or add a new one for specific paths
// This example targets files that need custom Babel plugins
config.module.rules.push({
test: /\\.tsx?$/,
include: [
path.resolve(__dirname, 'src/components/i18n'), // Example: specific directory
path.resolve(__dirname, 'packages/my-custom-lib'), // Example: monorepo package
],
exclude: /node_modules/,
use: [
{
loader: 'babel-loader',
options: {
presets: ['next/babel'],
plugins: [
path.resolve(__dirname, './plugins/my-i18n-babel-plugin.js'),
],
},
},
],
});
}
}
return config;
},
};
export default nextConfig;
SVGR thường được sử dụng để nhập các tệp SVG dưới dạng các thành phần React. Turbopack có hỗ trợ tích hợp cho SVGR, nhưng cấu hình có thể hơi khác một chút.
Vấn đề: Các tệp SVG không thể nhập được, hoặc các tệp SVG được xử lý như tài sản thô thay vì các thành phần.
Cách khắc phục: Đảm bảo next.config.mjs của bạn được cập nhật để xử lý SVGR của Turbopack. Next.js 15 đơn giản hóa điều này.
// next.config.mjs
/** @type {import('next').NextConfig} */
const nextConfig = {
webpack: (config, { isServer }) => {
// Remove the default Next.js SVG rule
const fileLoaderRule = config.module.rules.find((rule) =>
rule.test?.test?.('.svg')
);
if (fileLoaderRule) {
fileLoaderRule.exclude = /\\.svg$/;
}
// Add SVGR loader
config.module.rules.push({
test: /\\.svg$/,
use: ['@svgr/webpack'],
});
return config;
},
};
export default nextConfig;
Cấu hình này phần lớn tương thích với cả Webpack và Turbopack trong Next.js 15. Điều quan trọng là loại trừ SVG khỏi trình tải tài sản mặc định và sau đó áp dụng @svgr/webpack.
Turbopack không trực tiếp hỗ trợ các Webpack loader tùy ý. Nó có quy trình xử lý tài sản và chuyển đổi nội bộ riêng.
Vấn đề: Các tệp được xử lý bởi các Webpack loader tùy chỉnh (ví dụ: yaml-loader, các loader markdown tùy chỉnh, các trình tối ưu hóa hình ảnh cụ thể) không được xử lý đúng cách, dẫn đến lỗi xây dựng hoặc tải tài sản không chính xác.
Cách khắc phục:
// next.config.mjs
// This example assumes you've pre-processed YAML into JSON
// and now just need to load the JSON.
/** @type {import('next').NextConfig} */
const nextConfig = {
webpack: (config, { isServer }) => {
// If you pre-process .yaml to .json, you might just need to ensure .json is handled.
// Next.js handles .json by default.
// If you still need to load raw .yaml, you'd need a custom Turbopack transform
// or pre-convert it.
return config;
},
};
export default nextConfig;
Turbopack có cơ chế lưu trữ bộ nhớ đệm mạnh mẽ riêng. Trong khi Webpack thường dựa vào bộ nhớ đệm cache-loader hoặc filesystem, bộ nhớ đệm nội bộ của Turbopack được tối ưu hóa cao.
Vấn đề: Các cấu hình lưu trữ bộ nhớ đệm Webpack rõ ràng có thể bị bỏ qua hoặc xung đột, dẫn đến hành vi không mong muốn hoặc giảm hiệu suất.
Cách khắc phục: Xóa các cấu hình lưu trữ bộ nhớ đệm Webpack rõ ràng. Tin tưởng vào bộ nhớ đệm nội bộ của Turbopack. Đảm bảo môi trường CI/CD của bạn lưu trữ bộ nhớ đệm thư mục .next/cache đúng cách cho các bản dựng tăng dần.
# Example .gitlab-ci.yml or .github/workflows/main.yml snippet
cache:
paths:
- .next/cache # Cache Turbopack's build cache
- node_modules
next build bị lỗi khi Turbopack được bậtChế độ lỗi: Lệnh next build thoát với lỗi, thường là khó hiểu, khi experimental.turbopack: true được đặt trong next.config.mjs cho production. Điều này thường biểu hiện dưới dạng lỗi "Failed to compile" hoặc "Module not found" mà không xuất hiện trong quá trình phát triển.
Nguyên nhân gốc rễ:
resolve.alias phức tạp với các bộ giải quyết tùy chỉnh, cài đặt optimization cụ thể hoặc một số plugin Webpack) có thể không được hỗ trợ đầy đủ hoặc có ngữ nghĩa khác.Cách khắc phục:
experimental.turbopack: false hoặc xóa cờ) để xác nhận đó là nguyên nhân.next.config.mjs:
resolve.alias. Đảm bảo chúng là các bí danh đường dẫn đơn giản chứ không phải các hàm phức tạp.fs, path, crypto) trong mã phía client, bạn có thể cần phải polyfill chúng một cách rõ ràng hoặc đảm bảo chúng được loại trừ đúng cách cho mục tiêu trình duyệt.Chế độ lỗi: next build cục bộ với Turbopack nhanh, nhưng các pipeline CI/CD cho thấy ít hoặc không có sự cải thiện, hoặc thậm chí là suy giảm.
Nguyên nhân gốc rễ:
.next/cache không được duy trì giữa các lần chạy CI/CD. Turbopack phụ thuộc rất nhiều vào bộ nhớ đệm này để xây dựng tăng dần.rm -rf .next && next build).Cách khắc phục:
.next/cache: Cấu hình hệ thống CI/CD của bạn để lưu trữ bộ nhớ đệm thư mục .next/cache. Điều này là tối quan trọng đối với hiệu suất xây dựng tăng dần.
# Example for GitHub Actions
- name: Cache Next.js build
uses: actions/cache@v3
with:
path: |
~/.npm
${{ github.workspace }}/.next/cache
key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.ts', '**/*.tsx') }}
restore-keys: |
${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
rm -rf .next nếu thực sự cần thiết (ví dụ: nâng cấp phiên bản Next.js lớn, hoặc để gỡ lỗi bộ nhớ đệm bị hỏng).Chế độ lỗi: Các thay đổi đối với tệp không được phản ánh trong trình duyệt, hoặc HMR mất nhiều thời gian, ngay cả với Turbopack.
Nguyên nhân gốc rễ:
next.config.mjs không chính xác: Các cấu hình sai ngăn Turbopack xác định đúng ranh giới module hoặc các phụ thuộc.watchOptions tùy chỉnh trong Webpack: Nếu trước đây bạn có watchOptions tùy chỉnh trong Webpack, chúng sẽ bị Turbopack bỏ qua.Cách khắc phục:
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
next.config.mjs: Đảm bảo không có cấu hình webpack nào vô tình can thiệp vào chế độ dev của Turbopack.delegated hoặc cached cho các volume Docker nếu có thể./home/user/project) thay vì các ổ đĩa Windows được gắn kết (ví dụ: /mnt/c/Users/user/project) để có hiệu suất hệ thống tệp tối ưu.Có, Next.js 15 cho phép bật Turbopack cho các bản dựng production bằng cách đặt experimental.turbopack: true trong next.config.mjs của bạn. Mặc dù nó là mặc định cho quá trình phát triển, nhưng hỗ trợ production vẫn được coi là thử nghiệm nhưng đang trưởng thành nhanh chóng.
Turbopack không trực tiếp hỗ trợ các Webpack loader hoặc plugin. Nó có pipeline xử lý tài sản nội bộ và các phép biến đổi dựa trên SWC. Đối với các trường hợp sử dụng phổ biến như CSS, hình ảnh và SVG, Next.js 15 cung cấp các giải pháp tích hợp tương thích với Turbopack. Đối với các Webpack loader tùy chỉnh cao, bạn có thể cần viết lại chúng dưới dạng plugin SWC, tiền xử lý tài sản hoặc tìm các phương pháp thay thế.
Turbopack chỉ ảnh hưởng đến quá trình xây dựng Next.js. Các cấu hình Babel hiện có của bạn cho các công cụ như Storybook, Jest hoặc các phần không phải Next.js khác của monorepo của bạn sẽ không thay đổi và tiếp tục sử dụng Babel. Tuy nhiên, đối với các ứng dụng Next.js, bạn sẽ cần di chuyển các plugin Babel tùy chỉnh sang plugin SWC hoặc sử dụng dự phòng Babel như được mô tả trong phần di chuyển.
Trong hầu hết các trường hợp, đặc biệt đối với các ứng dụng lớn và monorepo, Turbopack nhanh hơn đáng kể so với Webpack đối với khởi động lạnh máy chủ phát triển và HMR. Đối với các bản dựng production, hiệu suất tăng cũng đáng kể nhưng có thể khác nhau tùy thuộc vào độ phức tạp của ứng dụng và các tối ưu hóa Webpack cụ thể mà bạn có thể đã có. Kiến trúc dựa trên Rust và biên dịch tăng dần được tối ưu hóa cao mang lại cho Turbopack một lợi thế hiệu suất cơ bản.
Trọng tâm chính của Turbopack là tốc độ xây dựng. Mặc dù nó sử dụng SWC để thu nhỏ và loại bỏ mã chết, vốn rất hiệu quả, nhưng tác động của nó đến kích thước gói cuối cùng so với một bản dựng Webpack được tối ưu hóa cao (ví dụ: với phân tách mã nâng cao, loại bỏ mã chết mạnh mẽ và các trình thu nhỏ tùy chỉnh) có thể không đáng kể hoặc thậm chí lớn hơn một chút trong một số trường hợp hiếm. Tuy nhiên, đối với hầu hết các ứng dụng, kích thước gói sẽ tương đương và những cải thiện về tốc độ xây dựng vượt xa những khác biệt nhỏ về kích thước.
Với việc Turbopack là bundler phát triển mặc định trong Next.js 15 nhưng là tùy chọn 'opt-in' cho môi trường production, ý nghĩa kỹ thuật quan trọng nhất đối với monorepo doanh nghiệp 10.000+ module là gì?
Làm sạch log AI CLI, tạo biểu thức cron, giải mã JWT và tính quyền chmod offline.

Hướng dẫn cấu trúc thư mục Next.js App Router đã được kiểm nghiệm trong thực tế. Tìm hiểu về route groups, private folders, colocation vs FSD, và tải xuống một template doanh nghiệp có khả năng mở rộng.
Đọc tiếp
Hướng dẫn toàn diện về các thành phần cache và server actions của Next.js 15: hướng dẫn kiến trúc sản xuất hoàn chỉnh với kiến trúc cấp độ sản xuất và các ví dụ code.
Đọc tiếp
Hướng dẫn chuẩn production toàn diện cho Next.js App Router: Ranh giới Server Components, caching nâng cao, streaming với Suspense, Server Actions, connection pooling và kiến trúc route cho enterprise.
Đọc tiếp