# VextJS 简体中文文档

> VextJS 的简体中文机器可读文档入口。当前前端模型是路由拥有的 SSR 与 hydration、可选 Streaming SSR，以及 esbuild 构建链；本版本明确不包含 React Server Components、Server Functions 和 PPR。

这是精简的简体中文索引。全部中文页面请使用完整中文索引；权威双语清单请使用文档 manifest。

## 从这里开始

- [介绍](https://devcodex-labs.github.io/vextjs/zh/guide/introduction): VextJS 是一个面向 API、服务端渲染 React 页面或两者并存场景的 Node.js 全栈框架。src/routes/ 始终拥有 URL，服务、校验、安全、缓存、OpenAPI 与类型客户端共用同一套请求契约。你可以从默认全栈脚手架起步，也可以保持 API-only，而不必引入第二套路由模型。
- [快速开始](https://devcodex-labs.github.io/vextjs/zh/guide/quick-start): VextJS 提供 vext create 命令创建可运行项目。默认模板会直接证明一套路由模型：/ 通过 res.render() 渲染 React，/api/hello 返回 JSON，两者都调用生成的 example service；不需要页面运行时则选择 API-only。
- [项目结构](https://devcodex-labs.github.io/vextjs/zh/guide/project-structure): VextJS 遵循 约定优于配置 的设计理念，通过固定的目录结构实现自动扫描、加载和注册，无需手动配置路由映射或服务注入。

## 前端运行时

- [前端总览](https://devcodex-labs.github.io/vextjs/zh/frontend/overview): 本前端指南描述 Vext 当前内置前端能力：route 驱动 React 19 页面、SSR、hydration、嵌套 layout、前端多语言、Fast Refresh、render refresh、代码拆分、静态资源、CDN 上传、性能预算和 hydration 验证。
- [渲染模式](https://devcodex-labs.github.io/vextjs/zh/frontend/rendering-modes): Vext 支持混合全栈前端模型，同时避免服务端文件进入浏览器 bundle。
- [边界与路线图](https://devcodex-labs.github.io/vextjs/zh/frontend/boundaries-and-roadmap): 本页区分当前前端目标和后续能力方向。
- [数据流](https://devcodex-labs.github.io/vextjs/zh/frontend/data-flow): Vext 前端数据从服务端开始。Route handler 调用 services，准备 JSON-safe 数据，再传给 res.render()。
- [性能预算](https://devcodex-labs.github.io/vextjs/zh/frontend/performance-budgets): 性能预算用于让 React hydration 路线可测、可控。

## 运行时与运维

- [路由](https://devcodex-labs.github.io/vextjs/zh/guide/routing): VextJS 采用 约定式文件路由 + 三段式路由定义，将文件路径自动映射为 URL 前缀，在文件内部通过 defineRoutes() 声明具体路由。
- [服务层](https://devcodex-labs.github.io/vextjs/zh/guide/services): VextJS 采用 分层架构，将业务逻辑集中在服务层（Service Layer）。服务文件放在 src/services/ 目录下，由框架自动扫描、实例化并注入到 app.services，路由 handler 中通过 app.services.xxx 访问。
- [构建 (vext build)](https://devcodex-labs.github.io/vextjs/zh/guide/build): vext build 会将服务端源码编译为可部署的 JavaScript 产物；当 frontend.enabled 为 true 时，还会把浏览器客户端打包到 dist/client/。当前版本的 vext build 按 production-target build 设计：它会对用户源码中的 process.env.NODEENV 做生产模式静态注入；运行时实际加载哪个配置 profile，由 vext start --config <name 或 VEXTCONFIG=<name 决定。基于 esbu...
- [部署与生产环境](https://devcodex-labs.github.io/vextjs/zh/guide/deployment): 本指南介绍如何将 VextJS 应用部署到生产环境，涵盖构建、Docker 容器化、Nginx 反向代理、PM2 进程管理、日志收集和健康检查等实践。
- [OpenAPI 文档](https://devcodex-labs.github.io/vextjs/zh/guide/openapi): VextJS 内置 OpenAPI 文档自动生成功能。基于路由的 validate 和 docs 配置，框架自动生成 OpenAPI 3.0 规范 JSON，并通过 Vext Docs Renderer 提供默认 /docs 文档页。第三方文档工具请直接消费 /openapi.json。

## 支持与机器可读文档

- [支持与服务](https://devcodex-labs.github.io/vextjs/zh/resources/support-and-services): 面向生产评审、迁移实施与团队赋能的 maintainer 参与式范围沟通入口。
- [文档数据与 AI](https://devcodex-labs.github.io/vextjs/zh/resources/documentation-data-and-ai): 面向 VextJS 的 canonical、机器可读文档资产，以及隐私优先的度量边界。

## 机器可读资产

- [文档 manifest](https://devcodex-labs.github.io/vextjs/docs-manifest.json): 权威双语页面元数据，包含 locale、适用面、关联页面和 source hash。
- [能力边界](https://devcodex-labs.github.io/vextjs/capabilities.json): 已支持的 frontend/runtime 能力与明确排除项。
- [AI 参考问题](https://devcodex-labs.github.io/vextjs/ai-gold-questions.json): 要求引用来源的评测问题。
- [事件合同](https://devcodex-labs.github.io/vextjs/docs-events.schema.json): 可选的隐私保护文档事件 schema；默认不启用 collector。
- [度量定义](https://devcodex-labs.github.io/vextjs/docs-dashboard-definition.json): 指标定义与采集边界。
- [完整简体中文文档索引](https://devcodex-labs.github.io/vextjs/zh/llms-full.txt): 由 manifest 生成的全部公开中文页面 URL 与摘要。

## 可选语言

- [英文索引](https://devcodex-labs.github.io/vextjs/llms.txt): 需要以英文文档为依据回答时，请使用英文 locale 的索引。