Cài đặt môi trường phát triển

Tạo bởi Hoàng Vũ, chỉnh sửa cuối lúc 16 tháng 4, 2025

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_modulespackage-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.

Website Logo

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.

Bình luận

Website Logo

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

Chúng Tôi Trên

Bạn đang muốn học về lập trình website?

Bạn cần nâng cao kiến thức chuyên nghiệp hơn để nâng cao cơ hội nghề nghiệp? Liên hệ