nvm: Trình Quản Lý Phiên Bản Node.js

Node Version Manager (nvm) là gì?

Node Version Manager (nvm) là một shell script tương thích POSIX — không phải file thực thi biên dịch sẵn — mà bạn source vào bash, zsh, ksh, dash, hay shell POSIX khác để cài đặt và chuyển đổi giữa các phiên bản Node.js. Nó chạy theo từng người dùng và từng shell: tự clone vào ~/.nvm (hoặc $XDG_CONFIG_HOME của bạn), rồi load như một shell function, nên các lệnh như nvm use chỉ đổi node đang active trong đúng phiên shell đó.

Khả năng chính của nvm

• ✓Chuyển phiên bản chỉ với một dòng lệnh: nvm install 24, nvm use 22, và nvm use 20 mỗi lệnh đổi node trên $PATH cho phiên shell đó, đúng như ví dụ trong README.
• ✓Các alias dựng sẵn ngoài số phiên bản thô — node (mới nhất), iojs (io.js mới nhất), stable/unstable (alias cũ từ trước bản 1.0), và current (phiên bản đang active, không bị ảnh hưởng bởi .nvmrc).
• ✓Nhắm tới dòng LTS bằng lts/* cho bản LTS mới nhất hoặc lts/argon cho một dòng release theo tên mã cụ thể, dùng được xuyên suốt install, uninstall, use, exec, run, và ls-remote.
• ✓Flag --reinstall-packages-from=<version> cài lại các package npm global lên phiên bản Node vừa cài mới, mà không âm thầm nâng cấp bản thân npm.
• ✓nvm exec và nvm which cho phép chạy một lệnh với một phiên bản Node cụ thể trong subshell, hoặc chỉ in ra đường dẫn tới binary của phiên bản đó, mà không cần đổi cả shell.
• ✓Install script chấp nhận override qua NVM_SOURCE, NVM_DIR, PROFILE, và NODE_VERSION, cùng flag --no-use để cài mà không kích hoạt phiên bản nào ngay.

Cài đặt và cập nhật nvm

Để cài hoặc cập nhật nvm, README hướng dẫn chạy install script qua lệnh curl hoặc wget một dòng. Script này clone repository nvm vào ~/.nvm (hoặc $XDG_CONFIG_HOME/nvm nếu biến đó tồn tại) và cố gắng thêm các dòng source vào đúng file profile — ~/.bashrc, ~/.bash_profile, ~/.zshrc, hoặc ~/.profile — nếu nó chỉnh nhầm file, đặt biến $PROFILE trỏ tới file đúng rồi chạy lại. Bạn có thể tuỳ biến nguồn cài, thư mục, profile, và phiên bản qua NVM_SOURCE, NVM_DIR, PROFILE, NODE_VERSION, thêm --no-use để cài mà chưa activate phiên bản nào, hoặc đặt PROFILE=/dev/null để install script không đụng vào shell config. Cài thủ công qua git cũng được, nhưng README yêu cầu git bản tối thiểu v1.7.10 để clone và checkout tag. Xác minh cài đặt bằng `command -v nvm` chứ không phải `which nvm`, vì nvm là một shell function được source chứ không phải binary thực thi. README cũng mô tả một cách cài trong Docker, source nvm qua biến BASH_ENV cho container non-interactive.

Quản lý các phiên bản Node.js với nvm

Cài một phiên bản cụ thể bằng `nvm install <version>`, hoặc dùng alias node cho bản mới nhất — phiên bản cài đầu tiên tự trở thành default cho các shell mới. `nvm use <version>` đổi phiên bản active trong shell hiện tại, `nvm run node --version` chạy node trực tiếp, còn `nvm exec <version> <command>` chạy một lệnh bất kỳ trong subshell với phiên bản chỉ định, không đổi default của shell. `nvm which <version>` in ra đường dẫn tới binary đã cài của phiên bản đó. `nvm alias <name> <version>` đặt alias riêng (không được chứa dấu cách hay dấu gạch chéo), và `nvm ls-remote` liệt kê các phiên bản có thể cài. Các cờ LTS (--lts, --lts=argon, 'lts/*', lts/argon) dùng được với install, uninstall, use, exec, run, và ls-remote. Để chuyển sang bản LTS mới nhất mà vẫn giữ các package đang cài, README đưa ra lệnh `nvm install --reinstall-packages-from=current 'lts/*'`.

Lựa chọn thay thế cho từng nền tảng và shell cụ thể

Câu hỏi thường gặp về nvm

Vấn đề nvm giải quyết

Các dự án khác nhau trên cùng một máy thường cần các bản Node.js major khác nhau — dự án này còn giữ một dòng LTS, dự án kia đang thử bản mới nhất — nhưng một bản cài Node.js toàn hệ thống (qua apt, trình cài đặt Windows, hay Homebrew) chỉ cho bạn một phiên bản tại một thời điểm, và đổi phiên bản đó thường cần sudo cùng việc cài lại thủ công. nvm giải quyết việc này bằng cách cài Node dưới thư mục home của từng người dùng và load một phiên bản cụ thể vào mỗi phiên shell, nên `node -v` có thể trả về kết quả khác nhau ở hai tab terminal mà không đụng tới trình quản lý gói của hệ điều hành.

Trường hợp sử dụng tốt nhất

• •Giữ song song nhiều bản Node major trên cùng một máy dev và chuyển đổi theo từng tab terminal bằng nvm use <version>, đúng như ví dụ trong README.
• •Build Docker non-interactive cần pin một phiên bản Node cụ thể — README có mô tả cách source nvm qua BASH_ENV vì shell non-interactive không đọc các file profile.
• •Nâng một dự án lên bản Node mới trong khi vẫn giữ lại các package npm global đã cài, qua --reinstall-packages-from.
• •Tham chiếu tới dòng LTS một cách chung chung (lts/*, lts/argon) trong script hoặc file .nvmrc thay vì hard-code một số phiên bản rồi lỗi thời.

Nên dùng — và nên bỏ qua khi nào

Hãy dùng nvm nếu bạn là developer trên macOS, Linux, hoặc WSL2, làm việc với nhiều dự án pin các bản Node major khác nhau, và muốn đổi phiên bản theo từng terminal mà không cần cài lại toàn hệ thống hay dùng sudo. Bỏ qua nếu bạn dùng Windows gốc không có WSL — hãy dùng nvm-windows, nodist, hoặc nvs thay thế — hoặc nếu bạn dùng Fish shell, nơi README hướng bạn tới nvm.fish hay fish-nvm; cũng nên bỏ qua bản cài qua Homebrew, vì README nói đường này không được hỗ trợ.

Repo liên quan