Fes.js 技术文档

安装指南

对于初学者的快速起步

Fes.js 提供了一键生成项目模板的便捷方式，你可以选择使用 pnpm 或 npm 进行初始化操作。

使用 pnpm

1. 创建新项目:

   pnpm create @fesjs/fes-app myapp
   

2. 安装依赖:

   pnpm i
   

3. 启动开发服务器:

   pnpm dev
   

使用 npm

如果你更习惯于使用 npm，同样简单:

1. 创建新项目:

   npx @fesjs/create-fes-app myapp
   

2. 安装依赖:

   npm install
   

3. 运行项目:

   npm run dev
   

开发环境配置

确保你的系统已经安装了 Node.js(v14 或更高版本)。Fes.js 建议使用 pnpm 作为包管理工具，因为它通常提供了更快的包安装速度和更少的磁盘占用。

项目的使用说明

Fes.js 设计哲学是“约定优于配置”，这意味着在多数情况下，遵循项目模板的结构和命名规则就足够开始你的开发。你的主要关注点应在于页面组件的创建和逻辑编写。

• 目录结构：遵循特定的目录规范，如 src/pages 存放页面组件，src/models 用于状态管理。

• 路由配置：支持配置式和约定式路由，通过修改 src/router/index.js 或保持目录结构的一致性即可。

• 国际化的使用：利用 @fesjs/plugin-locale 插件轻松实现多语言切换，配置文件位于 src/i18n。

• 状态管理：默认支持 Vuex，但推荐迁移到 Pinia，以适应 Vue3 的最新发展。

项目API使用文档

Fes.js 提供了一系列插件，每个都有其详细的API文档，可访问官方文档站 http://fesjs.mumblefe.cn/ 查阅。例如，对于API请求管理，@fesjs/plugin-request 描述了如何配置请求拦截器、错误处理策略等。

详细安装方式

详细步骤已在前文的“安装指南”部分给出。关键点在于通过模板初始化项目并安装必要的依赖。无论是选择 pnpm 还是 npm，务必确保按照指示依次执行创建项目、安装依赖、启动服务的步骤。

高级配置

对于高级用户，深入研究 Fes.js 的插件体系，可以让你根据项目需求定制化配置，从编译流程到运行时行为，都能做到高度可控。

结语

Fes.js 是为简化中后台应用开发而生的强大框架，通过本文档，你应该能够顺利地启动你的第一个 Fes.js 项目，并对它的基本用法有一个清晰的理解。记得利用官方文档和社区资源不断深化你的知识库，享受高效编码的乐趣。