安装

前置要求

• Node.js 20.19+ 或 22.12+（Vite 8 要求；推荐 22 LTS）
• npm（随 Node 安装）

用 node -v 确认版本。低于上述下限时，npm run dev / npm run build 可能直接失败。

当前项目不需要 .env、数据库或后端服务。

步骤

1. 克隆仓库

   git clone git@github.com:bucssatech22/CSSA-Website.git
   cd CSSA-Website

2. 安装依赖

   npm install

3. 启动开发服务器

   npm run dev

   npm start 与 npm run dev 相同，都是启动 Vite。

验证

浏览器打开 http://localhost:5173。应自动进入 /zh 首页，能看到 Navbar 与页脚。切换「EN」后地址变为 /en/...。

保存源文件后 Vite 会热更新，无需重启开发服务器。

常用命令

命令	说明
npm run dev / npm start	开发服务器，默认 5173
npm run build	生产构建，输出到 dist/
npm run preview	本地预览 dist/

下一步

• Quick Start — 改一条导航文案并确认热更新
• 更新页面内容 — 日常维护入口

框架官方文档见 官网文档首页 · 上游与参考。