1. Mục tiêu bài học

Sau khi hoàn thành bài học này, bạn sẽ:

• Hiểu kiến trúc Node.js: Nắm rõ bản chất của Node.js, V8 Engine và Libuv — so sánh trực tiếp với kiến trúc CPython và Event Loop trong Python.

• Thành thạo công cụ NPM & NPX: Làm chủ trình quản lý gói npm, biết cách khởi tạo dự án, quản lý dependencies và thực thi lệnh bằng npx.

• Cấu hình package.json chuẩn: Đọc, hiểu và quản lý cấu hình dự án JavaScript tương đương với pyproject.toml hay requirements.txt / Pipfile trong Python.

• Nắm vững hệ thống Module (CommonJS vs ES Modules): Phân biệt cách import/export code trong môi trường Node.js.

2. Bảng So sánh Kiến trúc & Công cụ (Python vs. Node.js)

Dù cùng phục vụ phát triển ứng dụng Server-side và Scripting, hệ sinh thái Node.js có những điểm tương đồng và khác biệt cốt lõi so với Python:

3. Phân tích Chi tiết & Kiến thức Cốt lõi

3.1. Bản chất Node.js: V8 Engine & Libuv

Node.js không phải là một ngôn ngữ lập trình, cũng không phải là một framework. Node.js là một JavaScript Runtime Environment cho phép chạy mã JavaScript bên ngoài trình duyệt (ở phía Server).

┌─────────────────────────────────────────────────────────────┐
│                       Node.js Runtime                       │
│  ┌─────────────────────────────┬─────────────────────────┐  │
│  │    V8 JavaScript Engine     │   Node.js Binding APIs  │  │
│  │   (Google - C++)            │   (fs, http, path...)   │  │
│  │   - Parse JS code           └────────────┬────────────┘  │
│  │   - JIT Compilation to Machine Code      │               │
│  └──────────────────────────────┬───────────┘               │
│                                 │                           │
│  ┌──────────────────────────────▼────────────────────────┐  │
│  │                         LIBUV                         │  │
│  │   - C-based Event Loop & Thread Pool                  │  │
│  │   - Handles Asynchronous I/O (File, Network, OS)     │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

1. V8 Engine: Do Google phát triển bằng C++, chịu trách nhiệm biên dịch mã JavaScript trực tiếp thành mã máy (Machine Code) bằng cơ chế Just-In-Time (JIT) Compilation giúp đạt tốc độ xử lý cực cao.

2. Libuv: Thư viện viết bằng C cung cấp Event Loop và Thread Pool ẩn bên dưới. Nhờ Libuv, các thao tác I/O nặng (đọc file, kết nối DB, HTTP call) được đẩy xuống cho hệ điều hành xử lý, giúp luồng chính của Node.js không bao giờ bị nghẽn (Non-blocking).

3.2. Cấu hình Dự án với package.json

Trong Python, bạn liệt kê thư viện vào requirements.txt. Trong Node.js, package.json vừa quản lý thư viện, vừa chứa metadata và các kịch bản chạy ứng dụng (scripts).

Tạo mới dự án:

mkdir my-app && cd my-app
npm init -y  # Khởi tạo package.json mặc định nhanh chóng

Cấu trúc package.json chuẩn:

{
  "name": "my-app",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "node index.js",
    "dev": "node --watch index.js"
  },
  "dependencies": {
    "express": "^4.19.2"
  },
  "devDependencies": {
    "nodemon": "^3.1.0"
  }
}

• dependencies: Các thư viện cần thiết để ứng dụng chạy trên môi trường Production (tương đương requirements.txt).

• devDependencies: Các công cụ chỉ dùng khi lập trình/testing (linter, bundler, test runner). Cài đặt bằng cờ -D: npm install -D nodemon.

• scripts: Định nghĩa các câu lệnh tắt. Chạy bằng lệnh: npm run dev hoặc npm start.

3.3. Sử dụng NPM và NPX

A. NPM (Node Package Manager) — Tương tự pip

NPM quản lý việc cài đặt, gỡ bỏ và cập nhật các gói thư viện từ registry npmjs.com.

# Cài đặt gói cho Production (Lưu vào dependencies)
npm install express

# Cài đặt gói cho Development (Lưu vào devDependencies)
npm install --save-dev typescript

# Gỡ bỏ gói
npm uninstall express

# Cài đặt lại toàn bộ thư viện từ package.json (Tương đương pip install -r requirements.txt)
npm install

B. NPX (Node Package Execute) — Tương tự pipx

NPX là công cụ đi kèm NPM, dùng để thực thi trực tiếp các gói CLI mà không cần cài đặt vĩnh viễn vào máy hoặc vào dự án.

# Tạo nhanh một dự án React mà không cần cài create-react-app toàn cục
npx create-react-app my-frontend

# Chạy linter hoặc format code nhanh
npx prettier --write .

3.4. Hệ thống Module: CommonJS vs. ES Modules (ESM)

Python chỉ có một cách import (import math / from math import sqrt). Ngược lại, Node.js có 2 hệ thống module do yếu tố lịch sử:

1. CommonJS (require / module.exports) — Mặc định truyền thống của Node.js

// math.js
const add = (a, b) => a + b;
module.exports = { add };

// main.js
const { add } = require('./math');
console.log(add(2, 3));

2. ES Modules (import / export) — Chuẩn ES6+ hiện đại (Khuyên dùng)

Để dùng cú pháp này trong Node.js, bạn thêm "type": "module" vào file package.json.

// math.js
export const add = (a, b) => a + b;
export default function multiply(a, b) { return a * b; }

// main.js
import multiply, { add } from './math.js'; // Lưu ý: Cần có đuôi file .js
console.log(add(2, 3));
console.log(multiply(2, 3));

4. Tóm tắt Quy tắc Thực hành Best Practices

1. Luôn thêm node_modules vào .gitignore: Thư mục node_modules/ rất nặng và chứa hàng ngàn file. Chỉ commit package.json và package-lock.json lên Git.

2. Luôn commit package-lock.json: File này ghi chính xác cây phụ thuộc (phiên bản cụ thể) giúp đảm bảo môi trường ở Production giống hệt môi trường Development.

3. Ưu tiên ES Modules ("type": "module"): Sử dụng chuẩn import/export đồng bộ với cú pháp JavaScript hiện đại trên Frontend và các framework backend mới.

5. Câu hỏi Suy ngẫm & Bài tập Thực hành

Bài tập 1: Phân tích và quản lý gói (Trắc nghiệm tư duy)

Trường hợp nào sau đây bạn nên sử dụng npm install --save-dev (-D) thay vì npm install thông thường?

1. Cài đặt framework web Express để tạo các RESTful API.

2. Cài đặt thư viện pg để kết nối với cơ sở dữ liệu PostgreSQL.

3. Cài đặt công cụ Jest để viết unit test cho ứng dụng.

4. Cài đặt thư viện jsonwebtoken để tạo token đăng nhập.

Bài tập 2: Khởi tạo và refactor Module dự án Node.js

Hãy tạo cấu trúc một module tính toán tài chính đơn giản chuyển đổi từ CommonJS sang ES Modules:

1. Tạo file package.json cấu hình dự án chạy dưới dạng ES Modules.

2. Tạo file calculator.js export một hàm Arrow Function calculateInterest(principal, rate, time) tính lãi đơn.

3. Tạo file index.js import hàm trên từ calculator.js, tính toán với principal = 1000, rate = 0.05, time = 2 và in kết quả ra console bằng lệnh node index.js.

Đáp án gợi ý:

• Bài tập 1:

  • Đáp án đúng: 3. Cài đặt công cụ Jest.

  • Giải thích: Unit test là công cụ chỉ phục vụ quá trình phát triển và kiểm thử code (Development/CI/CD), không cần thiết khi ứng dụng đã được đóng gói và triển khai thực tế trên server Production. Các tùy chọn 1, 2, 4 đều là thư viện trực tiếp xử lý request và dữ liệu của ứng dụng nên thuộc dependencies.

• Bài tập 2 (Mã nguồn mẫu):

  • package.json:

{
  "name": "financial-calc",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "node index.js"
  }
}

calculator.js:

export const calculateInterest = (principal, rate, time) => {
    return principal * rate * time;
};

index.js:

import { calculateInterest } from './calculator.js';

const interest = calculateInterest(1000, 0.05, 2);
console.log(`Lãi đơn nhận được: ${interest}`); // Output: Lãi đơn nhận được: 100