Các lệnh có sẵn
Trang này giải thích từng lệnh npm trong dự án làm gì thật sự, khi nào nên chạy, và kết quả khi chạy trên bản clone sạch. Một số lệnh có hành vi dễ gây hiểu nhầm, ví dụ next build không chạy lint.
Bảng lệnh
| Lệnh | Thực chạy | Khi nào dùng |
|---|---|---|
npm run dev | next dev --turbopack | Phát triển hằng ngày; Turbopack biên dịch theo yêu cầu, tự tải lại khi sửa file |
npm run build | next build | Kiểm tra bản production; biên dịch, kiểm tra kiểu và tạo trang tĩnh |
npm run start | next start | Chạy bản đã build; phải npm run build trước |
ANALYZE=true npm run build | next build kèm @next/bundle-analyzer | Xem từng chunk JS chứa gì; mở báo cáo HTML trong .next/analyze/ |
npm run lint | eslint . | Kiểm tra quy tắc mã nguồn |
npm test | jest | Chạy kiểm thử |
npm run docs:dev | vitepress dev docs | Khởi động máy chủ tài liệu cục bộ tại http://localhost:5173 |
npm run docs:build | vitepress build docs | Biên dịch website tài liệu tĩnh ra thư mục docs/.vitepress/dist |
npx tsc --noEmit | trình biên dịch TypeScript, không xuất file | Kiểm tra kiểu nhanh, không cần build |
Dự án không định nghĩa script riêng cho tsc; đó là lệnh npx gọi trực tiếp.
Chi tiết và lưu ý
npm run dev
Mặc định chạy ở cổng 3000. Đổi cổng bằng npm run dev -- --port 3111. Lần đầu mở mỗi trang sẽ chậm hơn vì phải biên dịch (trong lần chạy thử, trang đầu tiên mất khoảng 9,6 giây, các trang sau 0,2 đến 3 giây).
npm run build
- Cấu hình
eslint.ignoreDuringBuilds: truekhiếnnext buildinSkipping linting. Muốn kiểm tra lint phải chạynpm run lintriêng. - Vẫn có bước
Checking validity of types, nên lỗi kiểu làm build thất bại. - Chạy được khi không có
.envvà không có backend (xem Cài đặt). - Cần truy cập mạng để tải phông Google.
npm run lint
Dùng cấu hình next/core-web-vitals. Hiện trả 0 lỗi và 16 cảnh báo.
npm test
Truyền thêm tham số sau --, ví dụ npm test -- --ci hoặc npm test -- use-job-list. Hiện có 36 bộ test, 166 test. Chi tiết ở Kiểm thử.
npx tsc --noEmit
Nhanh hơn build và là cách kiểm tra kiểu phù hợp trước khi gửi code (khoảng 12 giây trong lần chạy thử).
Trước khi gửi thay đổi
Một bộ lệnh hợp lý, theo thứ tự nhanh đến chậm:
npx tsc --noEmit
npm run lint
npm test
npm run buildDự án chưa có workflow CI nào chạy các lệnh này tự động, nên việc chạy là trách nhiệm của người thay đổi.
Source code liên quan
package.json: định nghĩa scriptnext.config.ts:eslint.ignoreDuringBuildseslint.config.mjs: cấu hình lintjest.config.js: cấu hình Jesttsconfig.json: cấu hình TypeScript
