Vue.js – 渐进式 JavaScript 框架

Vue.js – 渐进式 JavaScript 框架是 Vue 3 官方中文文档站，提供完整教程、API 参考与生态指南，国内可直接访问 cn.vuejs.org，无需注册即可浏览全部内容。文档基于 MIT 开源协议免费开放，当前以 Vue 3 为主，Vue 2 已于 2023 年 12 月 31 日停止维护。

第一步：API 风格切换

文档最实用的功能之一是支持选项式 API 与组合式 API 两种代码示例的即时切换。在大部分章节的代码块上方，可以找到切换按钮，点击即可查看同一功能在不同风格下的实现。选项式 API 以组件选项对象组织逻辑，适合从 Vue 2 过渡的开发者；组合式 API 则利用 setup 函数或 script setup 语法糖，更利于逻辑复用和大型项目维护。两种风格完全覆盖响应式状态、计算属性、侦听器、生命周期等核心概念，切换时示例代码会同步变化，方便对比学习。

从 Vue 2 迁移到 Vue 3

针对仍在使用 Vue 2 的团队，文档提供了专门的迁移指南章节。该章节详细列出了破坏性变更，如 v-model 语法调整、key 属性作用变化、事件 API 替换等，并给出迁移步骤和代码示例。同时，文档还包含一个从 Vue 2 到 Vue 3 的对照表，帮助开发者快速定位旧 API 的对应新写法。迁移指南并非简单罗列差异，而是按影响程度分级，优先说明必须处理的变更，降低升级风险。

浏览官方生态与工具链

文档顶部导航栏直接集成了 Vue 生态的核心项目入口，包括状态管理库 Pinia、路由库 Vue Router、构建工具 Vite 等。每个生态项目均链接至其独立中文文档，形成连贯的学习路径。例如，在阅读完响应式基础后，可以无缝跳转到 Pinia 文档学习全局状态管理，或查阅 Vue Router 文档实现页面导航。这种生态导航设计避免了开发者在多个站点间反复搜索，提升查阅效率。

跟随互动教程快速上手

除了静态文档，站点还内置了互动教程，允许在浏览器中直接编写和运行 Vue 代码。教程从声明式渲染、属性绑定、事件处理等基础开始，逐步引入组件、插槽、路由等进阶主题。每个步骤都配有预设的代码模板和实时预览窗口，修改代码后结果即时反馈。互动教程无需本地安装任何工具，适合初次接触 Vue 的开发者快速建立直观理解。

分享生态导航

对于日常开发中的快速查阅需求，文档提供了完整的 API 参考章节。该章节按全局 API、组合式 API、内置组件、特殊元素等分类组织，每个 API 条目均包含类型签名、详细说明和代码示例。此外，文档还包含一个术语表，统一解释了响应式、副作用、虚拟 DOM 等常见概念，避免因术语理解偏差导致的使用错误。API 参考和术语表均支持页面内搜索，方便定位具体内容。