Skip to content

Framework ​

DevLink dùng Next.js 15 với App Router làm khung ứng dụng, React 18.2.0 làm thư viện giao diện và TypeScript 5.2.2 ở chế độ nghiêm ngặt. Trang này ghi các phiên bản, cấu hình đáng chú ý, và những điểm cần lưu ý khi nâng cấp.

Cách ứng dụng dùng App Router được mô tả ở Routing và layout và Server Component và Client Component.

Phiên bản ​

Công nghệKhai báoGhi chú
Next.js^15.4.10Đang cài 15.4.10
React, React DOM18.2.0Ghim đúng phiên bản
TypeScript5.2.2Ghim đúng phiên bản
eslint-config-next^13.5.1Cũ hơn Next.js hai phiên bản chính

Lệnh liên quan ​

LệnhThực chạy
npm run devnext dev --turbopack: dùng Turbopack
npm run buildnext build: không có cờ Turbopack
npm run startnext start
npm run linteslint .

Turbopack chỉ được bật cho môi trường phát triển.

Cấu hình Next.js ​

Trong next.config.ts:

Thiết lậpÝ nghĩa
experimental.authInterruptsBật các API thử nghiệm forbidden() và unauthorized() của Next.js; tại thời điểm viết chưa có nơi nào trong src/ gọi chúng
experimental.optimizePackageImports: ["lucide-react"]Chỉ nạp các biểu tượng Lucide được dùng
eslint.ignoreDuringBuilds: truenext build không chạy ESLint; phải chạy npm run lint riêng
images.remotePatternsCho phép ảnh từ http://localhost:8081/images/** và https://lh3.googleusercontent.com/**
Header Cross-Origin-Opener-Policy: same-origin-allow-popupsCho phép trang giữ liên lạc với cửa sổ popup do chính nó mở, thường cần cho đăng nhập qua popup như Google; code không ghi chú lý do
Header Referrer-Policy: no-referrer-when-downgradeÁp cho mọi đường dẫn
createNextIntlPlugin()Nạp cấu hình next-intl từ src/i18n/request.ts

Vì remotePatterns chỉ có localhost:8081, nếu ảnh từ backend đặt ở máy chủ khác và được hiển thị bằng next/image, cấu hình này cần được mở rộng. Địa chỉ này trùng với địa chỉ backend đang được viết cứng, xem Bối cảnh hệ thống.

TypeScript ​

Trong tsconfig.json: strict: true, target: ES2017, moduleResolution: bundler, isolatedModules: true, bí danh @/* trỏ tới ./src/*. Lệnh kiểm tra kiểu không biên dịch là npx tsc --noEmit.

Điểm cần lưu ý ​

  • Next.js 15 đi cùng React 18.2.0 trong dự án. Trước khi nâng React, cần đối chiếu yêu cầu phiên bản của các thư viện giao diện đang dùng.
  • eslint-config-next lệch phiên bản có thể khiến quy tắc lint không phản ánh các tính năng mới của Next.js 15. Chưa có ghi chép về việc đây là chủ ý hay chưa kịp cập nhật.

Source code liên quan ​

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code