快速开始

开始前准备

• 安装较新的 Node.js（建议 18+）
• 如果要部署到 Vercel，请先准备 Vercel 账号

使用 VCLight CLI（推荐）

创建项目：

npm

npx @vclight/cli create my-vclight-app

pnpm

pnpx @vclight/cli create my-vclight-app

或先全局安装 CLI：

npm

npm install -g @vclight/cli
vclight create my-vclight-app

pnpm

pnpm add -g @vclight/cli
vclight create my-vclight-app

CLI 会让你选择：

• 模板：带 Router 或空白模板
• 处理器：Vercel / Netlify / Node HTTP
• 可选功能：Prettier / .gitignore

手动搭建

npm

npm init -y
npm install vclight
npm install -D @types/node typescript

pnpm

pnpm init
pnpm add vclight
pnpm add -D @types/node typescript

如果要使用 Router，还需要安装：

npm

npm install @vclight/router

pnpm

pnpm add @vclight/router

入口文件示例

Vercel（Node 运行时）

import app from "./app/app";

export default app.vercelHandler();

Node HTTP

import * as http from "http";
import app from "./app/app";

const server = http.createServer();
server.on("request", app.httpHandler());
server.listen(3000);

Netlify Functions

import app from "../../src/app/app";

export default app.netlifyHandler();

本地调试

根据你选择的处理器，使用对应脚本：

• dev:vercel
• dev:netlify
• dev:http

例如：

npm run dev:vercel