准备工作 #

源码 #

阅读开发文档前，请确保手上已经有 Fantastic-admin 源码，因为文档中提及的内容，都是需要在本地项目中编写或修改代码并运行才能呈现的。如果还没有源码，可以通过下面两种方式获取：

基础版 #

手动下载

推荐去 Github Releases 页面下载最新版本的压缩包，如下图所示：

git 克隆

# 从 Gitee 克隆

# 拉取框架源码
git clone https://gitee.com/hooray/fantastic-admin.git
# 拉取演示源码
git clone -b example https://gitee.com/hooray/fantastic-admin.git

# 从 Github 克隆

# 拉取框架源码
git clone https://github.com/hooray/fantastic-admin.git
# 拉取演示源码
git clone -b example https://github.com/hooray/fantastic-admin.git

专业版 #

专业版用户会邀请加入到私有组织，获取源码的方式和基础版一致，只是仓库地址不同。

如果你想获取专业版源码，可以点这里去购买。

JS 版本 #

框架目前仅提供 TS 版本，如果需要使用 JS 版本，可以在仓库 tags 或 releases 页面里找到 v1.0.0 版本，这个是最后更新的 JS 版本，注意这是框架源码，演示源码只能从 git 提交记录中找了。

开发环境 #

使用本模板前，需要在本地依次安装好 Node.js, pnpm, Git 和 Visual Studio Code。

然后在 Visual Studio Code 里安装好以下扩展：

• EditorConfig for VS Code
• DotENV
• ESLint
• stylelint
• Vue Language Features
• TypeScript Vue Plugin

在 Visual Studio Code 里打开源码的文件夹，右下角会自动提示需要安装的依赖，直接点击安装即可。

除此之外，还需要准备好开发使用的浏览器，推荐使用 Chrome ，并且在 Chrome 里安装好 Vue.js devtools 扩展，安装 Vue 官方提供的调试工具在一定程度上可以提升解决 bug 的效率，当然这个扩展开启后，可能在开发环境操作会有些许卡顿，建议不需要时候可以将扩展禁用。

不过由于安装 Vue.js devtools 需要访问 Chrome 应用商店，如果在大陆地区访问，需要自行准备相关可访问外网的工具。如果不具备该条件，也可访问 Vue.js devtools 官网 了解本地构建或者下载支持 Edge/Firefox 的 Vue.js devtools 。

技术栈 #

了解并熟悉框架使用到的技术栈，能让你使用本框架更得心应手。

• Vite
• Vue 3 (v3 迁移指南)
• Vue Router 4
• Pinia
• Element Plus