1. 使用 pigx archetype 初始化项目

1.1 编译 pigx 项目

cd pigx/
mvn clean install

1.2 执行 archetype 生成模块

！！！！！必须使用cmd小黑屏执行，不能用powershell（最好新建一个文件夹例如：tmp暂存生成的模块，然后再拖进idea）

# 直接在win + R CMD小黑屏里面执行，不要使用 powershell 或者其他终端
mvn org.apache.maven.plugins:maven-archetype-plugin:3.1.0:generate ^
      -Dproject=pigx ^
      -DjavaVersion=17 ^
      -DgroupId=com.pig4cloud ^
      -DartifactId=demo ^
      -Dversion=5.9.0 ^
      -DarchetypeGroupId=com.pig4cloud.archetype ^
      -DarchetypeArtifactId=pigx-gen ^
      -DarchetypeVersion=5.9.0 ^
      -DarchetypeCatalog=local

-Dproject	pigx	项目名称，专属版本需要修改
-DjavaVersion	17	使用Java版本，只有17一个选项
-DgroupId	com.pig4cloud	项目包名前缀 ，专属版本需要修改
-DartifactId	demo	新增模块名称
-Dversion	5.9.0	项目版本号
-DarchetypeGroupId	com.pig4cloud.archetype	【固定值】，专属版本不需要修改
-DarchetypeArtifactId	pigx-gen	【固定值】，专属版本不需要修改
-DarchetypeVersion	5.9.0	【固定值】，archetype版本
-DarchetypeCatalog	local	【固定值】local

1.3可能出现的问题：

问题1.目录中识别不到POM

解决办法：在根POM文件中clean install

问题2：无法找到依赖或者无法使用Archetype插件0构建新模块

解决办法：使用cmd进行操作，不要用powershell

问题3：没有填写包名，使用默认包名导致错误

后果:如果使用你的模块名为pig-demo，使用默认包名，那么包名将会包含'-'，注意：Java包名通常使用反转的域名约定，全部小写，并且不应该包含连字符（-）。所以，默认的包名中有一个连字符是不合适的。

解决办法:应该将其修改为一个合法的包名，例如：'com.pig4cloud.pig.demo'

1.4生成的项目结构如下

demo
  ├── README.md
  ├── demo-api     # api 模块主要存放 实体、feign 调用接口
  │   ├── pom.xml
  │   └── src
  ├── demo-biz    # biz 模块主要存放 controller、业务service、mapper
  │   ├── pom.xml
  │   └── src
  └── pom.xml

2. 配置nacos和Pom文件

2.1在nacos中创建新的命名空间

注意：nacos端口在18080

2.2 克隆新的application-dev.yml到test

2.3 在根目录POM文件中进行配置

2.3.1复制此处的<profile>中的内容，并把id和profile.active改成刚刚创建的命名空间的名字

2.3.2 添加新的模块并且重载pom文件

注:模块为白色高亮状态并带有蓝色方块才表示被扫描到

此处也会出现test选项

3. 创建库表与代码生成

-- 创建测试库
create database `pigxx_demo` default character set utf8mb4 collate utf8mb4_general_ci;

USE pigxx_demo;

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- 创建测试表
DROP TABLE IF EXISTS `demo`;
CREATE TABLE `demo` (
  `id` bigint NOT NULL COMMENT '编号',
  `username` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL COMMENT '用户名',
  `password` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL COMMENT '密码',
  `del_flag` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT '0' COMMENT '删除标记',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin ROW_FORMAT=DYNAMIC COMMENT='demo 表';

3.1 新增数据源

启动codegen服务，并在前端文件的根目录执行npm run dev,进行数据源管理，填写对应的主机地址，端口号，数据库名字。

3.2 生成代码

选择数据源生成代码时，请注意包名称和模块名称。

注意：后端生成的代码路径是在新模块对应的biz目录下

前端就是在对应前端的路径

代码生成的包结构如下

├── demo_menu.sql   # 新增模块对应的菜单 SQL
├── pigx            # 后端代码包含增删改查代码
│   └── src
└── pigx-ui         # 前端代码包含页面
    └── src

3.3 菜单维护

3.3.1自动维护菜单

• 3.3.2 手动维护菜单不建议手动维护，很麻烦

3.4 模块名填写

如果模块名你的模块名为pig-demo，那么直接填写demo即可

3.5 路由配置

3.5.1，同步路由： 自动创建，则会自动创建一条【/demo】的网关路由，存在则跳过，不需要手动维护

3.5.2 - 进入 "基础工具" > "路由管理"，添加 demo-biz 对应的路由规则。 

4. 角色分配权限

给角色分配权限（角色管理 > 权限）。在重新启动前端并重新登录后，请!!!强制!!!刷新浏览器，查看 demo 功能是否生效。