本文帮助您快速了解Fastcms源码结构，并本地运行Fastcms项目。
在开始之前，您必须熟悉Java，Spring，SpringBoot，以及Mybatis-plus，熟练使用Mysql数据库，以及Maven；
您还需要了解Vue，typescript，elementui等前端知识。

环境准备

Fastcms 后端依赖 Java 环境来运行。如果您是从代码开始构建并运行Fastcms，还需要为此配置 Maven环境，请确保是在以下版本环境中安装使用:

64 bit OS，支持 Linux/Unix/Mac/Windows，推荐选用 Linux/Unix/Mac。 64 bit JDK 1.8+；下载 (opens new window) & 配置 (opens new window)。

Maven 3.6.x+；下载 (opens new window) & 配置 (opens new window)。

前端需要安装node 下载 (opens new window)，推荐版本v14.15.0及以上版本， 安装Vue，以及typescript环境

获取源码

git clone https://gitee.com/xjd2020/fastcms.git

构建后端源码

推荐使用idea，等待maven编译通过，如下图

源码目录结构说明

目录	说明
cms	文章，模板，cms相关功能代码
codegen	CRUD代码生成器
common	通用工具包
core	核心实现，插件，模板，安全，权限等功能代码实现
doc	简要文档，sql文件存放目录
plugins	helloworld插件实现代码
service	通用service代码实现
starters	第三方依赖集成目录，pf4j插件包，egzosn支付插件包，以及微信开发相关集成
ui	Vue，typescript，elementui前端工程代码
web	Fastcms web控制台代码实现

导入数据库脚本

推荐使用Mysql5.7+，数据库脚本在项目doc/sql/fastcms.sql

配置数据库链接

在web工程下面，打开resources下的application.yml文件，配置你本地数据库链接

  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/fastcms?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: root
    password: root

运行项目后端

打开web工程下，com.fastcms.web.Fastcms类，右键Run 'Fastcms';

@SpringBootApplication
@ComponentScan("com.fastcms")
@EnableScheduling
public class Fastcms {

    public static void main(String[] args) {
        SpringApplication.run(Fastcms.class, args);
    }

}

看到如下界面，说明后端服务启动成功

构建前端源码

推荐开发工具使用vscode，导入项目ui目录下的前端工程到vscode，如下图

安装依赖

npm install

运行前端工程

npm run dev

访问系统

系统默认账号密码 admin/1

http://localhost:8082