ServBay

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Appearance

Cách Kích Hoạt và Sử Dụng npm (Trình Quản Lý Gói Node.js) trong ServBay ​

npm (Node Package Manager) là công cụ quản lý gói chính thức của Node.js, đồng thời là một trong những kho phần mềm mã nguồn mở lớn nhất thế giới. Đối với các nhà phát triển Node.js, npm là công cụ không thể thiếu, giúp bạn dễ dàng cài đặt, chia sẻ và quản lý các phụ thuộc (dependency) của dự án. Nhờ môi trường tích hợp do ServBay cung cấp, bạn có thể nhanh chóng bắt đầu sử dụng npm để phát triển.

Yêu Cầu Trước Khi Bắt Đầu ​

Trước khi sử dụng npm, bạn cần cài đặt Node.js trong ServBay.

  1. Mở ứng dụng ServBay.
  2. Chuyển đến bảng điều khiển “Packages” (Các gói phần mềm).
  3. Tìm gói Node.js và đảm bảo rằng nó đã được cài đặt và đang chạy.

ServBay sẽ tự động thiết lập môi trường Node.js, trong đó đã bao gồm npm.

Kiểm Tra npm Đã Được Cài Đặt và Có Sẵn ​

Node.js được cài đặt qua ServBay đã đi kèm sẵn npm và mặc định đã bật. Bạn có thể kiểm tra nhanh trạng thái cài đặt của npm qua terminal.

  1. Mở ứng dụng Terminal của bạn (ví dụ Terminal trên macOS).

  2. Gõ lệnh sau để xem phiên bản của npm:

    bash
    npm -v

    Nếu lệnh thực thi thành công và hiện ra phiên bản (ví dụ như 10.2.0 hoặc cao hơn), nghĩa là npm đã được cài đặt đúng và sẵn sàng sử dụng trong môi trường hiện tại.

    bash
    # Kết quả mẫu
10.2.0

    Nếu xuất hiện lỗi kiểu “command not found: npm” (không tìm thấy lệnh npm), hãy chắc chắn rằng bạn đã cài đặt gói Node.js qua ServBay và đã tải đúng biến môi trường của ServBay (thường chỉ cần khởi động lại terminal hoặc máy tính là xong).

Cập Nhật npm ​

Mặc dù Node.js được cài cùng với một phiên bản npm ổn định thông qua ServBay, npm vẫn thường xuyên phát hành phiên bản mới một cách độc lập. Để cập nhật những tính năng và bản vá mới nhất, bạn có thể tự nâng cấp npm dễ dàng:

bash
npm install -g npm@latest

Lệnh này sẽ cài đặt phiên bản npm mới nhất ở phạm vi toàn hệ thống. Tham số -g giúp bạn có thể dùng phiên bản mới ở bất cứ đâu trong hệ thống.

Sau khi hoàn thành, hãy kiểm tra lại phiên bản với:

bash
npm -v

Chức Năng Chính và Cách Dùng npm Thường Gặp ​

Sức mạnh của npm đến từ hệ sinh thái mã nguồn mở rộng lớn và khả năng quản lý phụ thuộc một cách tiện lợi. Dưới đây là một số trường hợp và lệnh thông dụng nhất khi phát triển với npm:

Khởi Tạo Dự Án Node.js Mới ​

Khi bắt đầu một dự án Node.js trong thư mục trống, bạn nên dùng lệnh npm init để tạo file package.json. File này là trung tâm của dự án, chứa thông tin meta, danh sách phụ thuộc và các script có thể chạy của dự án.

bash
cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init sẽ hướng dẫn bạn điền tên dự án, phiên bản, mô tả, file khởi động v.v. Bạn cũng có thể sử dụng npm init -y để tạo một file package.json mặc định nhanh chóng.

Cài Đặt Phụ Thuộc Dự Án ​

Tại thư mục gốc dự án (nơi chứa file package.json), bạn có thể cài đặt toàn bộ các phụ thuộc cần thiết bằng lệnh:

bash
cd /Applications/ServBay/www/my-project.servbay.demo
npm install

Lệnh này đọc các trường dependencies và devDependencies trong file package.json để tự động tải các module phù hợp về thư mục node_modules của dự án.

Thêm Gói Phụ Thuộc Mới ​

Khi muốn bổ sung thư viện hoặc framework mới, bạn sử dụng:

bash
# Cài một phụ thuộc sử dụng khi chạy ứng dụng, ví dụ Express
npm install express

# Cài phụ thuộc phát triển, ví dụ cho test là Mocha
npm install mocha --save-dev

Mặc định, npm install <tên-gói> sẽ cài vào node_modules của dự án và cập nhật trường dependencies trong package.json. Tham số --save-dev giúp lưu gói vào trường devDependencies (cho môi trường phát triển, test hoặc build).

Gỡ Bỏ Phụ Thuộc ​

Nếu không còn cần một gói, bạn có thể gỡ bỏ bằng:

bash
npm uninstall express

Lệnh này sẽ xóa gói khỏi node_modules và cập nhật lại package.json.

Cập Nhật Phụ Thuộc Dự Án ​

Để đảm bảo các bản phụ thuộc được cập nhật (trong phạm vi cho phép ở package.json), hãy dùng:

bash
npm update

Lệnh này kiểm tra các gói trong node_modules và cập nhật chúng lên phiên bản mới nhất phù hợp với file package.json.

Sử Dụng npm Scripts ​

Trường scripts trong package.json cho phép bạn định nghĩa các script tùy chỉnh để tự động hóa các tác vụ lặp lại như chạy server, thực thi test, build project v.v.

Ví dụ, bạn có thể thêm vào package.json như sau:

json
{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

Sau đó, bạn có thể chạy các script trong terminal bằng:

bash
# Khởi động ứng dụng
npm start

# Chạy test
npm test

# Thực hiện build
npm run build

Lưu ý: Với một số tên script đặc biệt như start, test, install, restart, stop... bạn có thể bỏ qua run và dùng luôn như npm start, npm test.

Bảng Lệnh npm Thường Dùng ​

Ngoài các lệnh cơ bản trên, dưới đây là một số lệnh npm quan trọng khác:

  • Cài gói toàn cục: Dùng để cài các công cụ CLI dùng ở mọi nơi trên máy tính.

    bash
    npm install -g <tên-gói>
# Ví dụ, cài npx (thường đã có sẵn cùng Node.js)
npm install -g npx
# Cài công cụ thường dùng nodemon giúp tự động khởi động lại ứng dụng khi phát triển
npm install -g nodemon

  • Chạy lệnh tạm thời từ npx: npx (có sẵn từ npm 5.2 trở lên) giúp chạy các file thực thi trong node_modules/.bin hoặc tạm tải gói về chạy mà không cần cài toàn cục.

    bash
    # Tạo ứng dụng React mới mà không cài toàn cục create-react-app
npx create-react-app my-react-app

  • Xem danh sách gói đã cài toàn cục: Hiển thị các gói và phiên bản đã cài đặt ở chế độ toàn hệ thống.

    bash
    npm list -g --depth=0

  • Dọn dẹp cache của npm: Nếu gặp lỗi khi cài gói, thử dọn cache có thể giải quyết vấn đề.

    bash
    npm cache clean --force

  • Xem thông tin chi tiết một gói: Bao gồm các phiên bản, phụ thuộc, repo...

    bash
    npm view <tên-gói>

  • Tìm kiếm gói trên npm:

    bash
    npm search <từ-khóa>

Xử Lý Sự Cố Thường Gặp ​

  • npm command not found: Hãy đảm bảo bạn đã cài gói Node.js qua ServBay và terminal của bạn nhận biến môi trường đúng (thường chỉ cần khởi động lại terminal hoặc máy tính).
  • Cài đặt phụ thuộc thất bại: Kiểm tra lại kết nối mạng. Một số công ty có proxy chặn npm, có thể bạn cần cấu hình proxy hoặc thử dọn cache npm (npm cache clean --force) rồi thử lại.
  • Vấn đề quyền hạn (permission): Trên macOS, đôi khi cài gói toàn cục (npm install -g) sẽ gặp lỗi quyền hạn. Bạn nên dùng Node Version Manager (nvm) hoặc đảm bảo ServBay thiết lập đúng quyền, tuyệt đối tránh dùng trực tiếp sudo vì sẽ gây nhiều lỗi phức tạp khác. Node.js của ServBay thông thường đã thiết lập quyền hợp lý cho phép thao tác trong thư mục cài đặt.

Tổng Kết ​

Với ServBay, bạn dễ dàng thiết lập môi trường phát triển Node.js hoàn chỉnh trên máy tính của mình, sẵn sàng sử dụng công cụ mạnh mẽ npm để quản lý gói và phát triển dự án. Làm chủ các lệnh cũng như thao tác cơ bản với npm sẽ giúp bạn gia tăng đáng kể hiệu suất phát triển. Khi ngày càng đi sâu hơn vào hệ sinh thái Node.js, npm chắc chắn sẽ là trợ thủ không thể thay thế của bạn.