Cách dùng Tạo package.json
- Nhập tên và phiên bản package — tên sẽ được kiểm tra theo quy tắc đặt tên của npm ngay khi bạn gõ.
- Chọn một mẫu scripts (Node, Vite, Next.js, thư viện TypeScript) và loại module.
- Thêm license, tác giả, repository và phiên bản Node.js mà code của bạn cần.
- Sao chép hoặc tải file về thư mục gốc của dự án, rồi chạy
npm installđể thêm dependencies.
Các trường quan trọng nhất trong package.json
| Trường | Chức năng |
|---|---|
name | Tên package — viết thường, tối đa 214 ký tự, an toàn cho URL, có thể có scope (@org/name) |
version | Một phiên bản ngữ nghĩa (semantic version) như 1.4.2 |
type | "module" coi các file .js là ES modules (import); mặc định là CommonJS |
main / exports | Điểm vào mà code khác import. exports còn ẩn các file nội bộ |
scripts | Lệnh cho npm run dev, build, test… |
engines | Các phiên bản Node.js mà code của bạn hỗ trợ |
private | true ngăn npm publish vô tình |
packageManager | Ghim npm, pnpm hoặc Yarn qua Corepack |
Dependencies do trình quản lý gói thêm vào
Đừng gõ tay phiên bản dependencies — hãy chạy npm install react hoặc npm install -D vite, npm sẽ ghi chúng với dải phiên bản phù hợp (thường là ^). Hãy commit file lock để mọi người cài cùng một phiên bản.
Các bước tiếp theo cho dự án mới
Thêm một file .gitignore (ít nhất có node_modules/ và .env), một file .editorconfig, một README và một workflow GitHub Actions để chạy script test và build của bạn mỗi lần push.
Cũng được tìm dưới tên: package.json mẫu, npm init, package.json scripts, package.json exports, node package.json, quy tắc đặt tên npm package, package.json type module.
Các công cụ dùng kèm tốt với Tạo package.json
- Định dạng JSON — Dán JSON để định dạng đẹp, nén hoặc kiểm tra.
- Kiểm tra YAML — Dán file Docker Compose, manifest Kubernetes, workflow GitHub Actions hoặc bất kỳ YAML nào để xác định chính xác lỗi, phát hiện các lỗi thường gặp và nhận bản đã định dạng gọn gàng.
- Tạo Kubernetes YAML — Nhập tên ứng dụng, image và cổng, bạn sẽ có ngay Kubernetes YAML sẵn sàng cho production: một Deployment với probe, giới hạn tài nguyên và security context được gia cố, cùng Service, Ingress có TLS, ConfigMap, Secret và HorizontalPodAutoscaler mà bạn chọn — tất cả trong một file, sẵn sàng cho kubectl apply.
- Trình tạo systemd Service — Chạy ứng dụng của bạn như một dịch vụ Linux đúng chuẩn, tự khởi động cùng hệ thống và tự restart khi bị crash.
Câu hỏi thường gặp
Quy tắc đặt tên cho npm package là gì?
Chỉ dùng chữ thường, không có khoảng trắng, tối đa 214 ký tự, không được bắt đầu bằng dấu chấm hoặc gạch dưới, chỉ dùng ký tự an toàn cho URL (chữ cái, chữ số, - . _ ~), và không được trùng tên module lõi của Node.js như http. Tên có scope có dạng @scope/name.
Có nên dùng "type": "module" không?
Với dự án mới thì nên dùng — ES modules là chuẩn hiện nay và chạy được trên Node.js 18+, Vite và hầu hết công cụ. Chỉ dùng CommonJS khi bạn phụ thuộc vào công cụ yêu cầu require().
"private": true có tác dụng gì?
Nó khiến npm từ chối publish package, giúp ứng dụng và dự án nội bộ không bị publish nhầm.
Dependencies được khai báo ở đâu?
Hãy cài chúng bằng npm, pnpm hoặc Yarn; công cụ sẽ tự ghi vào dependencies hoặc devDependencies.
Tôi có thể cài Tạo package.json như một ứng dụng web và dùng khi không có mạng không?
Có. Tạo package.json là một ứng dụng web (PWA) có thể cài đặt — cài trực tiếp từ trình duyệt, không cần tải từ cửa hàng ứng dụng. Trên Chrome hoặc Edge (Windows, macOS, Linux, ChromeOS) hoặc Android, bấm Cài đặt ứng dụng ở đầu trang này; trên iPhone và iPad, dùng Chia sẻ → Thêm vào Màn hình chính; trên Mac, dùng File → Add to Dock trong Safari 17 trở lên. Sau đó ứng dụng mở trong cửa sổ riêng với biểu tượng riêng, và vì chạy hoàn toàn trên trình duyệt nên vẫn hoạt động khi không có mạng. Firefox trên máy tính không thể cài ứng dụng web. Cách cài đặt hoạt động thế nào.