Với một game puzzle hoặc arcade HTML5 mới năm 2026, hãy dùng Vite để serve và bundle một dự án TypeScript nhỏ, để TypeScript kiểm tra code một cách riêng biệt, và import asset thông qua module graph để URL production có thể được hash. Giữ cảnh chơi được đầu tiên ở dạng tải ngay (eager), rồi chỉ tải các màn chơi tùy chọn, phần hướng dẫn hay tính năng nặng khi người chơi cần; Rolldown của Vite 8 và TypeScript 7 là những bản nâng cấp đúng thời điểm, nhưng một cấu trúc dự án rõ ràng quan trọng hơn việc chạy theo tốc độ build.
Những điểm chính
- Bắt đầu với template TypeScript thuần của Vite và một cây source nhỏ, dễ đọc.
- Dùng các thiết lập TypeScript hướng trình duyệt, kiểm tra nghiêm ngặt và một lệnh type-check riêng.
- Import asset gameplay để có URL được hash; dành
public/cho các file cần tên cố định. - Tách nội dung tùy chọn tại các bước chuyển có ý nghĩa với người chơi, không phải ở mọi module.
- Trong Vite 8, Rolldown vận hành bundler và alias path của tsconfig có thể được bật ngay trong Vite.
Vì sao cách thiết lập này phù hợp với năm 2026?
Thông báo “Vite 8.0 is out!” của Vite vào tháng 3/2026 mô tả việc chuyển sang Rolldown làm bundler thống nhất viết bằng Rust. Bài tiếp theo “Vite 8.1 is out!” vào tháng 6 giới thiệu chế độ phát triển bundled dạng thử nghiệm cho các dự án cần đến. Bản phát hành này cũng gây ra một cuộc thảo luận trên Hacker News có tên “Vite 8.0 Is Out”, nơi các developer nêu các câu hỏi thực tế về công cụ mới và việc migrate. Những thay đổi này khiến Vite đặc biệt đáng dùng lúc này, nhưng bạn không cần các thiết lập thử nghiệm để phát hành một game canvas nhỏ.
Thay đổi đáng chú ý khác là TypeScript 7. Bài “Announcing TypeScript 7.0” của Microsoft vào tháng 7/2026 mô tả một bản port native bằng Go. Hãy coi các tuyên bố về tốc độ compiler là báo cáo của nhóm compiler, không phải lời hứa về dự án của bạn; hãy xác minh khả năng tương thích với editor và các plugin lint trước khi thay đổi một toolchain đang chạy tốt. Trong hướng dẫn này, Vite đảm nhiệm các phép biến đổi cho trình duyệt và đầu ra production, còn compiler TypeScript và ESLint thực hiện các bước kiểm tra tường minh.
“Vite 8 đi kèm Rolldown làm bundler duy nhất, thống nhất, viết bằng Rust, mang lại tốc độ build nhanh hơn tới 10-30 lần trong khi vẫn giữ tương thích đầy đủ với plugin.”
— Vite, Vite 8.0 is out!
Tôi nên khởi tạo một game như thế nào?
Hãy tạo một app thuần (vanilla) trước. Cài các phiên bản package tương thích hiện hành và commit lockfile được tạo ra để đồng đội và các máy build giải quyết cùng một dependency graph. Phiên bản package chính xác thay đổi liên tục, vì vậy hãy để package manager chọn các bản phát hành tương thích thay vì sao chép một phiên bản ghim đã cũ từ một bài viết.
Chạy npm create vite@latest nabi-puzzle -- --template vanilla-ts, cài dependency, rồi khởi động dev server. Thêm TypeScript và ESLint làm development dependency nếu starter của bạn chưa có sẵn.
Starter của Vite là bệ phóng hữu ích, không phải kiến trúc cuối cùng của bạn. Hãy xóa phần UI demo mà game không cần, rồi làm cho màn hình đầu tiên render nhanh: tạo canvas hoặc root của game, chỉ tải asset của boot scene, và hiển thị tiến độ hoặc một trạng thái loading thân thiện cho các file lớn hơn. NabiGame làm cả game casual trên web lẫn mobile, nên chúng tôi coi trọng cách tổ chức dự án giữ cho input, rendering và quy tắc game dễ hiểu khi cùng một cơ chế phải chuyển giữa các nền tảng. Xem hướng dẫn game web HTML5 của chúng tôi để biết bối cảnh triển khai và so sánh game engine để chọn engine.
Chọn cấu trúc thư mục xoay quanh trách nhiệm
Một dự án nhỏ nên làm rõ ràng nơi developer thay đổi quy tắc, màn hình, asset và code riêng cho từng nền tảng. Đừng xây một lớp engine tổng quát trước khi game cho thấy nhu cầu. Một cây khởi đầu thực tế có thể trông như sau:
Ví dụ, giữ điểm vào ở src/main.ts; tổ chức game/scenes, game/systems, input, ui, assets và styles dưới src; dành public cho các file có tên cố định.
Với một game merge puzzle như Juice Fruit, quy tắc bàn chơi có thể tách khỏi rendering và input. Điều đó làm cho logic tất định dễ suy luận hơn và cho phép giao diện thay đổi mà không phải viết lại mô hình puzzle. Nguyên tắc của chúng tôi: giữ mỗi file tập trung vào một lý do để thay đổi, nhưng đừng tách mọi hàm thành một file. Hãy để ranh giới phản ứng với các tính năng của game, chứ không phải một sơ đồ kiến trúc lý thuyết.
Thiết lập TypeScript nào phù hợp với game trình duyệt?
Hãy dùng chế độ module resolution hướng trình duyệt. Tài liệu TypeScript mô tả bundler là chế độ dành cho các bundler; nó chấp nhận import không có phần mở rộng theo cách một bundler có thể phân giải. Với app chỉ dùng Vite, noEmit đảm bảo TypeScript kiểm tra source mà không tạo ra bản build JavaScript thứ hai. Dev server của Vite biến đổi TypeScript, nhưng phép biến đổi nhanh của nó không thay thế cho việc kiểm tra kiểu.
{
"compilerOptions": {
"target": "ES2022",
"module": "ESNext",
"moduleResolution": "bundler",
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"strict": true,
"noEmit": true,
"skipLibCheck": true,
"types": ["vite/client"],
"baseUrl": ".",
"paths": { "@/*": ["src/*"] }
},
"include": ["src"]
}
Hãy dùng strict từ sớm. Trạng thái game thường đi qua nhiều giai đoạn, như khởi động, đang chơi, tạm dừng, đang xử lý, và các kiểu dữ liệu tốt sẽ phơi bày các chuyển đổi không hợp lệ ngay khi bạn còn đang định hình thiết kế. Hãy thêm các interface hẹp cho input và manifest asset thay vì ép mọi thứ về any. Tài liệu tham khảo moduleResolution của TypeScript giải thích vì sao chế độ bundler khác với các chế độ runtime của Node.
Làm cho alias hoạt động ở cả TypeScript lẫn Vite
Tùy chọn paths giúp editor và bộ kiểm tra hiểu các import, nhưng trước đây bundler cũng cần biết cách phân giải chúng. Vite 8 đã thêm hỗ trợ tsconfig path tích hợp sẵn sau resolve.tsconfigPaths; ghi chú phát hành Vite 8 cho biết tính năng này không được bật theo mặc định và có chi phí hiệu năng nhỏ. Với app nhỏ hơn, import tương đối hoàn toàn ổn. Nếu alias giúp code rõ ràng hơn, hãy bật tính năng này một cách tường minh hoặc cấu hình các alias tương ứng trong Vite, và xác minh rằng lint và test dùng cùng quy tắc phân giải.
“Hỗ trợ `paths` của tsconfig tích hợp sẵn: Developer có thể bật phân giải alias đường dẫn TypeScript bằng cách đặt `resolve.tsconfigPaths` thành `true`.”
— Vite, Vite 8.0 is out!
Import asset và hashing hoạt động ra sao?
Hãy import các file thuộc về game từ source. Khi đó Vite có thể đưa chúng vào build graph và viết lại URL khi các file đầu ra được gắn dấu vân tay (fingerprint). Điều này hữu ích với sprite, hiệu ứng âm thanh, font và dữ liệu màn chơi vì một file được cập nhật sẽ nhận URL mới, tránh cache cũ của trình duyệt.
Ví dụ, import fruitUrl from './assets/fruit.png' cho game một URL của hình ảnh, và import popUrl from './assets/pop.ogg' làm tương tự cho một hiệu ứng âm thanh.
TypeScript cần các khai báo client của Vite để hiểu các import asset; đó là lý do cấu hình có vite/client. Hãy giữ các file triển khai ổn định như favicon hay file robots trong public/, nơi Vite sao chép chúng mà không hash. Đừng tự dựng đường dẫn asset từ tên file trừ khi bạn hiểu các quy tắc phân tích tĩnh của bundler. Hướng dẫn Static Asset Handling của Vite đề cập đến URL import, chuỗi raw, worker và thư mục public.
“Các asset được tham chiếu sẽ nằm trong build assets graph, được đặt tên file có hash và có thể được xử lý bởi các plugin để tối ưu hóa.”
— Vite, Static Asset Handling
Khi nào nên tách code game thành các chunk?
Code splitting nghĩa là trì hoãn một module tùy chọn cho đến khi người chơi cần đến. Đừng tách vòng lặp input, mô hình bàn chơi hay cảnh chơi được đầu tiên chỉ để báo cáo bundle trông gọn gàng; trình duyệt phải tải chúng trước khi chơi. Những ứng viên tốt gồm lớp phủ trợ giúp, trình xem replay tùy chọn, trình chỉnh sửa màn chơi hoặc bộ định nghĩa các chương sau. Một dynamic import tạo ra ranh giới tự nhiên:
async function openHowToPlay(): Promise{ const { showTutorial } = await import('./ui/tutorial') showTutorial() } document .querySelector ('[data-help]') ?.addEventListener('click', () => void openHowToPlay())
Vite xử lý các async chunk và có thể preload các dependency trực tiếp của chúng. Tuy vậy, một chunk thêm một request mạng và có thể phải chờ vào đúng lúc cần đến. Hãy dùng trạng thái loading cho một chế độ tùy chọn lớn và kiểm thử trên một chiếc điện thoại chậm. Bài viết tháng 4/2025 của Chrome “More accurate DevTools performance debugging using real-world data” mô tả việc hiệu chỉnh CPU throttling trong DevTools và cũng giải thích những gì throttling không thể mô phỏng. Hãy profile trên thiết bị thật cho các quyết định cuối cùng. Về ngân sách render nặng canvas, xem ngân sách hiệu năng cho game web mobile của chúng tôi.
“CPU throttling không thể mô phỏng mọi khía cạnh của phần cứng di động.”
— Chrome for Developers, More accurate DevTools performance debugging using real-world data
Nên đặt gì trong vite.config.ts?
Hãy giữ cấu hình nhỏ và tường minh. Ví dụ này giả định game được phát hành ở gốc domain và bật hỗ trợ alias tích hợp của Vite 8. Với game được host dưới một thư mục con, hãy đặt base thành đường dẫn triển khai đó hoặc dùng base tương đối khi phù hợp. Hướng dẫn build production giải thích cách Vite điều chỉnh URL asset được import cho một base lồng nhau.
import { defineConfig } from 'vite'
export default defineConfig(({ mode }) => ({
base: '/',
resolve: { tsconfigPaths: true },
build: {
sourcemap: mode === 'development',
assetsInlineLimit: 0,
},
}))
Đặt assetsInlineLimit bằng 0 giữ cả các file nhỏ ở dạng bên ngoài; đó là lựa chọn có chủ ý về cache và khả năng kiểm tra, không phải mẹo tăng tốc chung cho mọi trường hợp. Hãy bỏ nó đi nếu các asset giao diện nhỏ được nhúng sẽ tốt hơn. Source map production có thể giúp chẩn đoán lỗi, nhưng hãy quyết định có công bố chúng hay không dựa trên nhu cầu gỡ lỗi và mức độ lộ source. Một thỏa hiệp phổ biến là upload riêng tư lên hệ thống theo dõi lỗi và không triển khai map công khai.
Debug flag, source map và linting nên hoạt động thế nào?
Hãy dùng các cờ mode tích hợp sẵn của Vite cho các công cụ hỗ trợ chỉ dành cho development. Vite thay thế tĩnh các giá trị này khi build, cho phép loại bỏ code chết. Đừng bao giờ đặt secret vào biến VITE_: bất cứ thứ gì lộ ra theo cách này đều nằm trong code client. Hãy dùng backend cho thông tin xác thực và các quyết định đáng tin cậy.
if (import.meta.env.DEV) {
window.addEventListener('keydown', (event) => {
if (event.key === '`') console.table(game.debugSnapshot())
})
}
Với các công tắc tùy chỉnh, hãy dùng một biến được đặt tên rõ ràng như VITE_SHOW_HITBOXES=true, phân tích giá trị chuỗi của nó và giữ mặc định là tắt. Hướng dẫn môi trường của Vite ghi nhận DEV, PROD và các file .env theo mode.
“Vite đưa ra một số hằng số nhất định dưới đối tượng đặc biệt `import.meta.env`.”
— Vite, Env Variables and Modes
Hãy thêm các script riêng cho development, type check, linting và build production. Ví dụ, check có thể chạy tsc --noEmit, còn lint chạy ESLint trên src. Hướng dẫn tính năng của Vite khuyến nghị tách phân tích tĩnh khỏi pipeline biến đổi của nó. Cách này giữ cho dev server phản hồi nhanh và cho ra lỗi rõ ràng khi một vấn đề về kiểu hay phong cách cần chặn việc phát hành. Hãy thêm các quy tắc lint dần dần: bắt các import không dùng và mẫu code không an toàn, nhưng tránh các tranh luận về định dạng làm chậm một đội nhỏ.
Năm 2026, TypeScript 7 là một bản phát hành công cụ quan trọng, nhưng khả năng tương thích với editor và plugin vẫn là mối quan tâm thực tế. Một trình tự hợp lý là dùng phiên bản compiler ổn định được toolchain của bạn hỗ trợ, giữ lệnh type-check độc lập với Vite, và thử compiler mới trên một nhánh trước khi chuyển hẳn. Mục tiêu là phản hồi đáng tin cậy trong lúc lặp game, chứ không phải chạy theo một con số phiên bản cho có.
Checklist thiết lập thực tế
- Khởi tạo template Vite TypeScript thuần và xóa code demo không dùng.
- Bật các kiểu trình duyệt nghiêm ngặt và chạy TypeScript với
noEmit. - Giữ quy tắc game, scene, input, UI và asset trong các thư mục rõ ràng.
- Import các asset game hay thay đổi; đặt các file triển khai có tên cố định vào
public/. - Tách nội dung tùy chọn bằng dynamic import và hiển thị trạng thái loading ở nơi cần thiết.
- Dùng
import.meta.env.DEVcho các lớp phủ cục bộ; đừng bao giờ phát hành secret trong biến môi trường frontend. - Build với chính sách source map và base path được chọn cho host thực tế, rồi kiểm tra đầu ra trên mobile.
- Chạy lint, type check và build như các bước kiểm tra riêng biệt trước khi phát hành.
Với các đội cần art game, hỗ trợ triển khai hoặc một ý kiến thứ hai về kế hoạch từ web sang mobile, trang dịch vụ của chúng tôi phác thảo những công việc chúng tôi nhận. Chúng tôi khuyên bạn nên bắt đầu với một lát cắt chơi được: một cảnh, một bộ asset nhỏ và một vòng tương tác hoàn chỉnh. Nó bộc lộ các vấn đề kiến trúc sớm hơn là việc dựng khung cầu kỳ.
FAQ
Vite có tự động type-check TypeScript không?
Không. Vite biến đổi TypeScript cho development và production, nhưng việc kiểm tra kiểu nên chạy riêng. Hãy thêm một lệnh tsc --noEmit riêng vào script và chạy nó trước khi phát hành.
Tôi có nên dùng Vite 8 cho một game HTML5 mới không?
Vite 8 là điểm khởi đầu hiện hành hợp lý khi plugin và runtime của bạn hỗ trợ. Tích hợp Rolldown của nó nay là mặc định, trong khi chế độ phát triển bundled ở Vite 8.1 vẫn là thử nghiệm. Một game nhỏ thường không cần các tùy chọn thử nghiệm.
Có nên dynamic import mọi màn chơi không?
Không. Hãy tách nội dung khi nó lớn hoặc không cần ở lần chơi đầu, như các chương sau hoặc phần hướng dẫn. Giữ đường tương tác đầu tiên ngắn và tránh thêm thời gian chờ vào các tính năng người chơi cần ngay.
Asset của game có nên đặt trong public không?
Thông thường, hãy import các asset được code game tham chiếu để Vite có thể theo dõi và hash chúng. Dùng public/ cho các file cần tên ổn định hoặc không được import từ source.
Tôi có thể đặt key analytics vào biến VITE_ không?
Chỉ những giá trị dự định công khai mới thuộc về biến môi trường phía client. Vite bundle các giá trị có tiền tố vào code trình duyệt, nên thông tin xác thực riêng tư phải ở lại trên server.
Nguồn
- Vite 8.0 is out!
- Vite 8.1 is out!
- Announcing TypeScript 7.0
- Vite Features
- Vite Static Asset Handling
- Vite Env Variables and Modes
- Vite Building for Production
- Vite Performance
- TypeScript moduleResolution
- Chrome: More accurate DevTools performance debugging using real-world data
- Hacker News discussion: Vite 8.0 Is Out

Comments
Loading comments…