47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
---
|
|
title: "Kiểm tra Node.js + npm (Đường dẫn PATH)"
|
|
summary: "Hướng dẫn kiểm tra phiên bản Node.js/npm và xử lý lỗi lệnh moltbot không tìm thấy"
|
|
read_when:
|
|
- Bạn đã cài đặt Moltbot nhưng khi gõ lệnh hệ thống báo "command not found"
|
|
- Bạn đang thiết lập Node.js/npm trên máy tính mới
|
|
---
|
|
|
|
# Kiểm tra Node.js + npm (Đường dẫn PATH)
|
|
|
|
Moltbot yêu cầu phiên bản **Node 22 trở lên**.
|
|
|
|
Nếu bạn đã chạy lệnh cài đặt thành công nhưng sau đó gõ `moltbot` mà hệ thống báo "command not found", thì nguyên nhân hầu như luôn là do **đường dẫn PATH**: Thư mục chứa các tệp thực thi của npm chưa được khai báo với hệ điều hành.
|
|
|
|
## Kiểm tra nhanh
|
|
Hãy chạy các lệnh sau:
|
|
```bash
|
|
node -v # Kiểm tra phiên bản Node
|
|
npm -v # Kiểm tra phiên bản npm
|
|
npm prefix -g # Xem thư mục cài đặt gốc của npm
|
|
```
|
|
Nếu thư mục kết quả của lệnh `npm prefix -g` không nằm trong danh sách của lệnh `echo $PATH`, máy tính của bạn sẽ không biết tìm lệnh `moltbot` ở đâu.
|
|
|
|
## Cách sửa: Thêm npm vào đường dẫn PATH
|
|
|
|
### Trên macOS / Linux
|
|
1. Tìm đường dẫn thực tế bằng lệnh `npm prefix -g`.
|
|
2. Thêm dòng sau vào tệp cấu hình trình khởi chạy của bạn (thường là `~/.zshrc` hoặc `~/.bashrc`):
|
|
```bash
|
|
export PATH="$(npm prefix -g)/bin:$PATH"
|
|
```
|
|
3. Mở một cửa sổ Terminal mới để thay đổi có hiệu lực.
|
|
|
|
### Trên Windows
|
|
Hãy thêm đường dẫn kết quả từ lệnh `npm prefix -g` vào biến môi trường **PATH** trong phần cài đặt "System Environment Variables" của Windows.
|
|
|
|
## Xử lý lỗi quyền hạn (Linux)
|
|
Nếu bạn gặp lỗi `EACCES` khi cài đặt (không có quyền ghi vào thư mục hệ thống), hãy chuyển thư mục cài đặt npm về thư mục cá nhân của bạn:
|
|
```bash
|
|
mkdir -p "$HOME/.npm-global"
|
|
npm config set prefix "$HOME/.npm-global"
|
|
export PATH="$HOME/.npm-global/bin:$PATH"
|
|
```
|
|
|
|
---
|
|
Tài liệu liên quan: [Chi tiết trình cài đặt](./installer.vi.md), [Xử lý lỗi](../gateway/troubleshooting.vi.md).
|