Cài đặt Node.js và npm: Hướng dẫn cho người mới

Bạn đang muốn học JavaScript nhưng không biết bắt đầu từ đâu? Hay bạn đã nghe đến Node.js nhưng chưa hiểu nó là gì và cần cài như thế nào? Bài viết này sẽ hướng dẫn bạn từng bước cài đặt Node.js và npm trên Windows, macOS và Linux — hoàn toàn phù hợp cho người mới bắt đầu. Sau khi đọc xong, bạn sẽ có thể chạy chương trình JavaScript đầu tiên trên máy tính của mình.

Node.js là gì và tại sao cần cài đặt?

JavaScript ban đầu chỉ chạy được bên trong trình duyệt web (Chrome, Firefox...). Tuy nhiên, Node.js là một môi trường runtime cho phép bạn chạy JavaScript bên ngoài trình duyệt — trực tiếp trên máy tính, server, hoặc các thiết bị khác.

Nếu bạn chưa biết JavaScript là gì, hãy đọc bài JavaScript là gì? Tổng quan cho người mới bắt đầu trước khi tiếp tục.

Node.js được sử dụng rộng rãi để:

• Xây dựng web server và API (backend)
• Tạo công cụ dòng lệnh (CLI tools)
• Xử lý file, tự động hóa tác vụ
• Phát triển ứng dụng real-time như chat, game online

Hiểu đơn giản: JavaScript là ngôn ngữ, còn Node.js là "máy phiên dịch" giúp chạy JavaScript ngoài trình duyệt. Không có Node.js, bạn sẽ không thể viết code server-side bằng JavaScript.

npm là gì?

npm (viết tắt của Node Package Manager) là trình quản lý gói đi kèm với Node.js. Khi bạn cài Node.js, npm được cài tự động — không cần cài riêng.

Bạn có thể hình dung npm như một "chợ ứng dụng" dành cho Node.js. Tại đó có hơn 2 triệu thư viện mã nguồn mở mà bạn có thể dùng miễn phí. Muốn xây dựng web server? Cài Express. Muốn làm giao diện? Cài React. Tất cả chỉ cần một lệnh.

Để hiểu sâu hơn về npm, bạn có thể đọc bài npm là gì? Hướng dẫn sử dụng cho người mới.

Nên chọn phiên bản LTS hay Current?

Khi truy cập trang nodejs.org, bạn sẽ thấy hai lựa chọn: LTS và Current. Vậy nên chọn cái nào?

Kết luận: Người mới bắt đầu luôn chọn LTS. Phiên bản LTS ổn định hơn, được hỗ trợ lâu hơn, và tương thích với hầu hết các thư viện phổ biến.

Cách cài đặt Node.js trên Windows và macOS

Đây là cách đơn giản nhất, phù hợp cho người mới: tải file cài đặt trực tiếp từ trang chủ.

Trên Windows

1. Truy cập https://nodejs.org
2. Nhấn nút LTS (có dòng chữ "Recommended For Most Users") để tải file .msi
3. Mở file vừa tải và làm theo hướng dẫn wizard (chỉ cần nhấn "Next" liên tục)
4. Sau khi cài xong, đóng và mở lại Command Prompt hoặc PowerShell

Lưu ý: Sau khi cài xong bắt buộc phải khởi động lại terminal. Nếu không, lệnh node sẽ không được nhận dạng.

Trên macOS

1. Truy cập https://nodejs.org
2. Nhấn nút LTS để tải file .pkg
3. Mở file và làm theo hướng dẫn (nhấn "Tiếp tục" → "Cài đặt")
4. Sau khi cài xong, mở Terminal mới và kiểm tra

Cài đặt trên Linux và sử dụng nvm

Linux (Ubuntu/Debian)

Mở Terminal và chạy lệnh sau:

sudo apt update
sudo apt install nodejs npm

Nếu muốn cài phiên bản LTS mới nhất, dùng NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Dùng nvm (Node Version Manager)

nvm cho phép cài và chuyển đổi giữa nhiều phiên bản Node.js. Đây là cách được khuyến nghị cho developer chuyên nghiệp trên macOS/Linux:

# Cài đặt nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Khởi động lại terminal, sau đó cài LTS
nvm install --lts
nvm use --lts

Trên Windows, bạn có thể dùng nvm-windows với cú pháp tương tự.

Kiểm tra cài đặt và chạy chương trình đầu tiên

Sau khi cài xong (dù bằng cách nào), hãy mở terminal và chạy:

node --version
npm --version

Nếu thấy số phiên bản hiển thị (ví dụ: v22.14.0 và 10.9.2), bạn đã cài đặt thành công!

Viết chương trình Node.js đầu tiên

Tạo một file mới tên hello.js và nhập đoạn code sau:

// hello.js
console.log("Xin chào, Node.js!");

Lưu file lại, rồi chạy trong terminal:

node hello.js

Nếu thấy dòng chữ Xin chào, Node.js! xuất hiện — chúc mừng! Bạn đã chạy thành công chương trình JavaScript đầu tiên ngoài trình duyệt.

Bây giờ hãy thử viết thêm ví dụ với biến trong JavaScript để làm cho chương trình phong phú hơn:

// gioi_thieu.js
const ten = "codeahoc";
const namHoc = 2026;
console.log("Chào mừng đến với " + ten + "!");
console.log("Năm học: " + namHoc);

node gioi_thieu.js

Lỗi thường gặp và cách khắc phục

Lỗi 1: 'node' không được nhận dạng (Windows)

Triệu chứng: 'node' is not recognized as an internal or external command

Nguyên nhân: PATH chưa được cập nhật sau khi cài đặt.

Cách sửa: Đóng hoàn toàn Command Prompt / PowerShell rồi mở lại. Nếu vẫn lỗi, kiểm tra biến môi trường PATH và đảm bảo có đường dẫn đến thư mục cài Node.js (thường là C:\Program Files\nodejs).

Lỗi 2: EACCES: permission denied (macOS/Linux)

Triệu chứng: Lỗi quyền truy cập khi chạy npm install -g.

Nguyên nhân: Thiếu quyền ghi vào thư mục global của npm.

Cách sửa: Cài lại Node.js bằng nvm — cách này giải quyết vấn đề quyền hoàn toàn.

Lỗi 3: npm install chạy mãi không xong

Nguyên nhân: Kết nối mạng chậm hoặc registry npm bị chặn.

Cách sửa: Kiểm tra kết nối mạng. Nếu vẫn chậm, kiểm tra lại cấu hình registry:

npm config get registry
# Kết quả mong đợi: https://registry.npmjs.org/

Lỗi 4: Xung đột phiên bản Node.js

Triệu chứng: Các lệnh hoạt động lạ sau khi cài nhiều phiên bản.

Cách sửa: Dùng nvm để quản lý phiên bản. Chạy nvm list để xem các phiên bản đã cài, rồi nvm use <version> để chọn phiên bản muốn dùng.

Tổng kết

Qua bài viết này, bạn đã nắm được:

• Node.js là môi trường chạy JavaScript ngoài trình duyệt
• npm là trình quản lý gói đi kèm, giúp cài thư viện dễ dàng
• Người mới luôn chọn phiên bản LTS
• Cách cài đơn giản nhất: tải trực tiếp từ nodejs.org
• Kiểm tra thành công bằng node --version và npm --version

Bước tiếp theo, hãy khám phá cách sử dụng npm để cài các thư viện cho dự án của bạn. Nếu gặp lỗi hoặc có thắc mắc trong quá trình cài đặt, hãy để lại bình luận bên dưới — chúng tôi sẽ hỗ trợ bạn!