Cài đặt môi trường phát triển
Trong bài học này, bạn sẽ được hướng dẫn chi tiết cách chuẩn bị môi trường làm việc với Nuxt 3. Chúng ta sẽ cùng cài đặt các công cụ cần thiết như Node.js và VSCode, sau đó sử dụng nuxi
– CLI chính thức của Nuxt – để khởi tạo project đầu tiên. Bài học cũng sẽ cung cấp giải thích rõ ràng cho các lệnh cơ bản và cách xử lý một số lỗi phổ biến khi cài đặt.
Mục tiêu bài học
- Cài đặt đầy đủ môi trường phát triển Nuxt 3
- Biết sử dụng
nuxi
CLI để khởi tạo project - Hiểu các lệnh cơ bản để chạy và phát triển dự án
- Biết cách xử lý lỗi thường gặp khi setup

Cài đặt môi trường phát triển
1. Cài đặt Node.js và VSCode
Node.js
- Truy cập: https://nodejs.org
- Tải phiên bản LTS (khuyên dùng)
- Sau khi cài, kiểm tra:
node -v
npm -v
Yêu cầu: Node ≥ 18
VSCode
- Truy cập: https://code.visualstudio.com
- Cài đặt các extension gợi ý:
- Vue Language Features (Volar)
- Prettier
- ESLint
- Tailwind CSS IntelliSense (nếu dùng Tailwind sau này)
2. Cài đặt Nuxt 3 bằng nuxi
CLI
Tạo project Nuxt mới:
npx nuxi init my-nuxt-app
-
npx
: chạy lệnh từ npm mà không cần cài đặt toàn cục -
nuxi init
: tạo scaffold project -
my-nuxt-app
: tên thư mục project (bạn có thể đổi tùy ý)
Di chuyển vào thư mục và cài package:
cd my-nuxt-app
npm install
3. Giải thích các câu lệnh cơ bản
Câu lệnh | Ý nghĩa |
---|---|
npx nuxi init <tên> |
Tạo project Nuxt mới |
npm install |
Cài đặt toàn bộ dependencies (node_modules) |
npm run dev |
Chạy project ở chế độ phát triển (dev server) |
npm run build |
Build project cho production |
npm run preview |
Xem thử sau khi build (giống bản live) |
Khởi chạy project lần đầu:
npm run dev
- Kết quả: bạn có thể truy cập trang ở
http://localhost:3000
4. Các lỗi thường gặp và cách xử lý
Lỗi | Nguyên nhân | Cách xử lý |
---|---|---|
npx: command not found |
Node chưa cài hoặc chưa thêm PATH | Kiểm tra lại cài Node.js |
Error: Requires Node >=18 |
Node phiên bản thấp hơn yêu cầu | Update Node lên bản mới |
Không thể chạy npm install |
Mạng chậm, proxy, hoặc package-lock.json lỗi |
Thử xóa node_modules và package-lock.json , rồi cài lại |
vite báo lỗi không tìm thấy file |
Do thiếu config hoặc folder | Đảm bảo pages/index.vue tồn tại và hợp lệ |
Không thấy gì ở localhost:3000 |
Project chưa chạy hoặc port bị chiếm | Đảm bảo npm run dev đang chạy, hoặc thử đổi port (PORT=4000 npm run dev ) |
Kết luận
Việc cài đặt đúng môi trường là bước đầu tiên quan trọng để học và làm việc với Nuxt.js. Bạn đã biết cách cài đặt Node.js, VSCode và sử dụng nuxi
CLI để tạo project Nuxt 3 cơ bản. Bên cạnh đó, bạn cũng đã nắm các lệnh thường dùng và biết cách xử lý một số lỗi phổ biến. Trong bài tiếp theo, chúng ta sẽ bắt đầu làm việc với project vừa tạo – tìm hiểu cách Nuxt tự động tạo routing và hiển thị trang đầu tiên.

Với hơn 10 năm kinh nghiệm lập trình web và từng làm việc với nhiều framework, ngôn ngữ như PHP, JavaScript, React, jQuery, CSS, HTML, CakePHP, Laravel..., tôi hy vọng những kiến thức được chia sẻ tại đây sẽ hữu ích và thiết thực cho các bạn.
Xem thêm

Chào, tôi là Vũ. Đây là blog hướng dẫn lập trình của tôi.
Liên hệ công việc qua email dưới đây.
lhvuctu@gmail.com