Vite là công cụ tạo và chạy dự án frontend rất nhanh, được tài liệu chính thức của React khuyên dùng cho ứng dụng chạy phía trình duyệt. Bài này hướng dẫn cài Node.js, tạo dự án, tìm hiểu cấu trúc thư mục và build sản phẩm.
- Cài Node.js và kiểm tra npm
- Tạo dự án React bằng Vite
- Hiểu cấu trúc thư mục và luồng chạy
- Chạy dev, build và preview
Cơ sở lý thuyết
Mã nguồn React (JSX, nhiều mô-đun, thư viện npm) không chạy trực tiếp được trên trình duyệt; cần công cụ build. Các khái niệm nền:
- Node.js: môi trường chạy JavaScript ngoài trình duyệt; công cụ build chạy trên Node.
- npm (Node Package Manager): quản lý gói; package.json khai báo dự án và các phụ thuộc, package-lock.json khóa phiên bản chính xác để mọi máy cài giống nhau; node_modules chứa mã gói đã cài (không đưa lên Git).
- Phiên bản ngữ nghĩa (SemVer) MAJOR.MINOR.PATCH: "^19.1.0" cho phép cập nhật MINOR và PATCH.
- Bundler gom nhiều mô-đun thành ít tệp tối ưu; transpiler (esbuild, Babel) chuyển JSX/TypeScript thành JavaScript.
- Vite khi phát triển phục vụ trực tiếp ES modules gốc của trình duyệt nên khởi động gần như tức thì, kèm HMR (thay mô-đun nóng – cập nhật giao diện không tải lại trang, giữ nguyên trạng thái); khi build dùng Rollup để đóng gói, rút gọn, chia nhỏ mã.
- Create React App đã ngừng được khuyến nghị; tài liệu react.dev khuyên dùng framework (Next.js, React Router) hoặc Vite.
Khái niệm
- Node.js: môi trường chạy JavaScript ngoài trình duyệt; đi kèm npm để cài thư viện.
- Vite: máy chủ phát triển (dev server) nạp lại tức thì khi sửa mã và công cụ đóng gói (build) cho bản chạy thật.
- Build: gộp, rút gọn mã thành các tệp HTML, CSS, JS tĩnh trong thư mục
dist/.
Tạo dự án
node -v # cần Node.js bản LTS
npm -v
npm create vite@latest my-react -- --template react
# hoặc dùng TypeScript: --template react-ts
cd my-react
npm install
npm run dev # mở http://localhost:5173Cấu trúc thư mục
| Tệp/thư mục | Vai trò |
|---|---|
| index.html | Trang HTML duy nhất, có thẻ div id="root" |
| src/main.jsx | Điểm khởi đầu: gắn component App vào #root |
| src/App.jsx | Component gốc của ứng dụng |
| src/assets/ | Ảnh, biểu tượng dùng trong mã |
| public/ | Tệp tĩnh giữ nguyên đường dẫn |
| package.json | Danh sách thư viện và lệnh npm |
// src/main.jsx
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import App from "./App.jsx";
createRoot(document.getElementById("root")).render(
<StrictMode>
<App />
</StrictMode>
);Các lệnh thường dùng
| Lệnh | Ý nghĩa |
|---|---|
| npm run dev | Chạy máy chủ phát triển |
| npm run build | Tạo bản chạy thật trong dist/ |
| npm run preview | Xem thử bản đã build |
| npm install tên-gói | Cài thêm thư viện |
Ứng dụng thực tế
Bài toán: sau khi build, vì sao tệp có tên như index-B3x9Kd.js? Đó là mã băm nội dung giúp trình duyệt lưu đệm lâu dài: nội dung đổi thì tên đổi, người dùng luôn nhận bản mới. Cấu hình thường gặp khi triển khai:
npm create vite@latest qlsv -- --template react
cd qlsv && npm install
npm run dev # máy chủ phát triển, HMR
npm run build # tạo thư mục dist/ tối ưu
npm run preview # xem thử bản build// vite.config.js – đặt website trong thư mục con và proxy API khi phát triển
export default defineConfig({
plugins: [react()],
base: "/qlsv/", // triển khai tại tuhoctin.net/qlsv/
server: { proxy: { "/api": "http://localhost:8000" } }, // tránh lỗi CORS khi phát triển
});Cài tiện ích VS Code "ES7+ React snippets": gõ rfce rồi Tab để sinh nhanh khung component.
Create React App (create-react-app) đã ngừng được khuyến nghị; nên dùng Vite hoặc framework như Next.js cho dự án mới.
- Tạo dự án my-react và chạy thử.
- Sửa App.jsx hiển thị tên và lớp của bạn, quan sát trang tự cập nhật.
- Chạy npm run build rồi npm run preview.
- Vite tạo dự án React nhanh và gọn.
- main.jsx gắn App vào thẻ #root.
- dist/ là bản tĩnh để triển khai.

