NPM (Node Package Manager) là gì? Cách hoạt động và lệnh cơ bản

Gần như mọi dự án JavaScript hiện đại đều bắt đầu bằng lệnh npm install. Vậy NPM (Node Package Manager) là gì, nó quản lý thư viện cho dự án ra sao và vì sao file package.json lại quan trọng đến vậy? Bài viết giải thích cơ chế hoạt động của npm, các lệnh thường dùng, điểm khác biệt so với Yarn, pnpm và những lưu ý bảo mật cần nắm.
NPM (Node Package Manager) là gì?
NPM là trình quản lý gói (package manager) mặc định của Node.js. Nó giúp lập trình viên tải, cài đặt, cập nhật và gỡ bỏ các thư viện JavaScript do cộng đồng chia sẻ, thay vì phải tự tải mã nguồn và sao chép thủ công vào dự án.
Tên gọi phổ biến của npm là Node Package Manager. Tuy nhiên, tài liệu chính thức chỉ viết thường là “npm”. npm được Isaac Z. Schlueter phát triển từ năm 2010. Năm 2020, npm, Inc. được GitHub mua lại và hiện npm do GitHub duy trì.
Theo tài liệu chính thức, npm gồm ba thành phần tách biệt:
| Thành phần | Chức năng |
| Registry | Cơ sở dữ liệu công khai chứa các package JavaScript và metadata đi kèm (phiên bản, tác giả, dependency). Mặc định npm kết nối tới https://registry.npmjs.org. |
| CLI | Công cụ dòng lệnh chạy trong terminal. Đây là cách phần lớn lập trình viên làm việc với npm hằng ngày. |
| Website | npmjs.com, nơi tìm kiếm package, xem tài liệu, quản lý tài khoản, tổ chức và quyền truy cập package riêng tư. |
Một package là thư mục hoặc file nén có chứa file package.json mô tả nó. Express, React, Lodash hay TypeScript đều được phân phối dưới dạng package trên npm registry.

NPM hoạt động như thế nào?
Khi chạy npm install, npm đọc danh sách dependency trong package.json, truy vấn registry để tìm phiên bản phù hợp, sau đó tải về và đặt vào thư mục node_modules. Kết quả được ghi vào package-lock.json.
package.json: “hồ sơ” của dự án
package.json là file JSON nằm ở thư mục gốc dự án. File này khai báo tên, phiên bản, script và các dependency. Hai nhóm dependency quan trọng nhất là:
- dependencies: thư viện cần khi ứng dụng chạy thực tế, ví dụ Express hoặc một driver cơ sở dữ liệu.
- devDependencies: công cụ chỉ dùng trong quá trình phát triển và build, ví dụ ESLint, Jest, TypeScript.
Một package.json tối giản có dạng:
{
"name": "my-api",
"version": "1.0.0",
"scripts": { "start": "node index.js", "test": "jest" },
"dependencies": { "express": "^4.21.0" },
"devDependencies": { "jest": "^29.7.0" }
}Semantic Versioning và ký hiệu ^, ~
npm sử dụng Semantic Versioning (SemVer) với định dạng MAJOR.MINOR.PATCH. MAJOR tăng khi có thay đổi phá vỡ tương thích, MINOR khi thêm tính năng tương thích ngược, PATCH khi sửa lỗi.
Ký hiệu trước số phiên bản quyết định phạm vi được phép cập nhật. Với ^4.21.0, npm chấp nhận mọi bản 4.x từ 4.21.0 trở lên nhưng không lên 5.0.0. Với ~4.21.0, npm chỉ chấp nhận bản vá trong nhánh 4.21.x. Không có ký hiệu nghĩa là cố định đúng phiên bản đó.
package-lock.json và node_modules
Vì package.json chỉ khai báo khoảng phiên bản, hai lần cài ở hai thời điểm có thể nhận về phiên bản khác nhau. package-lock.json khắc phục điều này bằng cách ghi lại chính xác phiên bản, nguồn tải và mã băm toàn vẹn (integrity) của từng package, kể cả dependency gián tiếp.
Thực hành chuẩn là commit package-lock.json lên Git, nhưng đưa node_modules vào .gitignore. Thư mục node_modules có thể tái tạo hoàn toàn từ hai file trên và thường rất nặng.
Cài đặt và kiểm tra NPM
npm được cài kèm khi bạn cài Node.js từ trang chính thức nodejs.org hoặc qua trình quản lý phiên bản như nvm. Sau khi cài, kiểm tra bằng:
node -v
npm -vMỗi dòng Node.js đi kèm một phiên bản npm nhất định, và phiên bản này có thể chậm hơn bản npm mới nhất. Khi cần cập nhật riêng npm, dùng lệnh npm install -g npm@latest. Trong môi trường nhóm hoặc CI/CD, nên thống nhất phiên bản Node.js và npm để tránh khác biệt khi cài đặt.
Các lệnh NPM thường dùng
Bảng dưới tổng hợp những lệnh npm xuất hiện thường xuyên nhất trong công việc hằng ngày:
| Lệnh | Công dụng |
| npm init -y | Tạo nhanh package.json với giá trị mặc định. |
| npm install <pkg> | Cài package và thêm vào dependencies. Viết tắt: npm i. |
| npm install -D <pkg> | Cài package vào devDependencies. |
| npm install -g <pkg> | Cài toàn cục, dùng cho công cụ dòng lệnh. |
| npm uninstall <pkg> | Gỡ package khỏi node_modules và package.json. |
| npm update | Cập nhật package trong phạm vi phiên bản cho phép. |
| npm outdated | Liệt kê package đã có phiên bản mới hơn. |
| npm run <script> | Chạy script khai báo trong package.json. |
| npm ci | Cài đặt sạch, đúng theo package-lock.json; phù hợp cho CI/CD. |
| npm audit | Quét lỗ hổng bảo mật đã biết trong cây dependency. |
| npm publish | Xuất bản package lên registry. |
Cần phân biệt npm install và npm ci. npm install có thể cập nhật lock file khi package.json thay đổi. npm ci yêu cầu lock file khớp với package.json, xóa node_modules hiện có và cài lại chính xác. Vì vậy npm ci cho kết quả ổn định hơn trên máy chủ build.
So sánh npm với npx, Yarn và pnpm
npx không phải trình quản lý gói riêng mà là công cụ đi kèm npm. Nó cho phép chạy lệnh từ một package mà không cần cài toàn cục, ví dụ npx create-vite@latest my-app.
Ngoài npm, hệ sinh thái Node.js còn có Yarn và pnpm. Cả ba đều dùng chung npm registry và package.json, khác nhau chủ yếu ở cách lưu trữ và cài đặt:
| Tiêu chí | npm | Yarn | pnpm |
| Cài sẵn với Node.js | Có | Không | Không |
| Lock file | package-lock.json | yarn.lock | pnpm-lock.yaml |
| Cách lưu package | Mỗi dự án có node_modules riêng | node_modules hoặc Plug’n’Play (Yarn Berry) | Kho lưu trữ chung, liên kết vào dự án qua hard link |
| Điểm mạnh | Mặc định, tương thích rộng | Hỗ trợ monorepo, nhiều chế độ cài đặt | Tiết kiệm dung lượng đĩa, cây dependency chặt chẽ |
Với đa số dự án, npm là đủ. Dù chọn công cụ nào, cả nhóm nên dùng thống nhất một công cụ và một loại lock file.
Lưu ý bảo mật khi sử dụng NPM
Một dự án có thể kéo theo hàng trăm dependency gián tiếp, nên rủi ro tấn công chuỗi cung ứng (supply chain attack) là có thật. Kẻ tấn công có thể chiếm tài khoản người duy trì package hoặc phát hành package có tên gần giống package phổ biến (typosquatting) để chèn mã độc.
Để giảm rủi ro, nên áp dụng các nguyên tắc sau:
- Kiểm tra nguồn gốc, người duy trì và mức độ hoạt động của package trước khi cài.
- Commit package-lock.json và dùng npm ci trong pipeline để cài đúng phiên bản đã kiểm duyệt.
- Chạy npm audit định kỳ và xem xét kỹ trước khi dùng npm audit fix --force, vì lệnh này có thể nâng phiên bản MAJOR.
- Bật xác thực hai lớp (2FA) cho tài khoản npm, đặc biệt với tài khoản có quyền publish.
- Không lưu token npm trực tiếp trong mã nguồn; dùng biến môi trường hoặc trình quản lý secret của hệ thống CI.
Đáng chú ý, npm 12 phát hành ngày 8/7/2026 đã thay đổi một số mặc định theo hướng an toàn hơn. Các install script của dependency (preinstall, install, postinstall) không còn tự động chạy nếu chưa được cho phép. Dependency lấy từ Git hoặc URL từ xa cũng không được phân giải nếu không bật rõ ràng. Lập trình viên phê duyệt script bằng lệnh npm approve-scripts và lưu danh sách cho phép trong package.json.
Nếu dự án dùng package cần biên dịch native module, hãy kiểm tra lại quy trình build và changelog trước khi nâng cấp npm trên môi trường CI.
Câu hỏi thường gặp về NPM
NPM có miễn phí không?
Có. CLI npm là mã nguồn mở, và việc cài cũng như xuất bản package công khai lên npm registry là miễn phí. npm có các gói trả phí cho nhu cầu như package riêng tư của tổ chức.
Có nên xóa thư mục node_modules không?
Có thể xóa khi gặp lỗi cài đặt hoặc cần giải phóng dung lượng. Chỉ cần chạy lại npm install hoặc npm ci để tái tạo, miễn là package.json và package-lock.json còn nguyên.
Nên cài package toàn cục hay cục bộ?
Ưu tiên cài cục bộ trong dự án để mỗi dự án tự quản lý phiên bản. Chỉ cài toàn cục với công cụ dòng lệnh dùng chung. Với công cụ chỉ chạy một lần, dùng npx sẽ gọn hơn.
Có thể dùng npm với registry riêng không?
Có. Bạn có thể cấu hình registry khác qua file .npmrc hoặc lệnh npm config set registry <url>, thường dùng cho package nội bộ của doanh nghiệp.
Kết luận: NPM là nền tảng của hệ sinh thái Node.js: registry lưu trữ package, CLI giúp cài đặt và quản lý dependency, còn package.json cùng package-lock.json đảm bảo dự án được tái tạo nhất quán trên mọi máy. Nắm vững SemVer, phân biệt npm install với npm ci và tuân thủ các nguyên tắc bảo mật sẽ giúp dự án ổn định hơn khi phát triển và triển khai.
Khi đưa ứng dụng Node.js lên môi trường thực tế, bạn có thể triển khai trên Cloud Server hoặc container hóa và vận hành bằng Cloud Kubernetes của VNPT Cloud để chủ động tài nguyên và mở rộng theo nhu cầu.



