签入版本

EasyGoAdmin_GoFrame_AntdVue/zh/generator/config.md

@@ -0,0 +1,79 @@
+# 10.7 配置文件详解
+
+:::tip 概述
+生成器配置在 config.yaml 的 generator 块：parentMenuId（菜单挂载父级）与 overwrite（覆盖开关，唯一入口）。CLI 与 HTTP 共用同一份配置。
+:::
+
+## 配置项
+
+```yaml
+generator:
+  parentMenuId: 189           # 新模块菜单挂载的父级ID
+  overwrite: false            # 是否覆盖已存在文件：true 生成即覆盖，
+                              # false 或未配置时缺失补生成、存在跳过
+```
+
+## parentMenuId（菜单挂载位置）
+
+```text
+作用：createMenu 创建的主菜单挂到哪个父节点下
+默认：189（"代码生成"或指定的模块分组菜单 ID）
+
+操作：
+  1. 菜单管理页面查目标父菜单的 ID
+  2. 修改 parentMenuId 为该 ID
+  3. 生成——新模块菜单出现在该父级下（sort=同级 MAX+5）
+
+注意：
+  * 父级不存在时菜单挂载失败（看 Menu.Message）
+  * 路径仍为 /{domain}/{moduleCamel}（与挂载位置无关）
+```
+
+## overwrite（覆盖开关，唯一入口）
+
+| 值 | 行为 | 适用 |
+|----|------|------|
+| false / 未配置 | 缺失补生成、存在跳过（Skipped） | **默认/推荐**——保护手工修改 |
+| true | 生成即覆盖（Overwritten） | 全新表首次生成；或有意整体重生成 |
+
+::: warning 覆盖风险
+overwrite=true 会覆盖同名文件（**包括手工修改过的**）。批量覆盖前：
+1. git 提交或备份手工改动
+2. 或临时改回 false 按需补生成
+3. 覆盖结果单独计入 Overwritten——生成后核对该列表
+:::
+
+## 其他相关配置
+
+```yaml
+# 数据库（生成器内省元数据的来源）
+database:
+  default:
+    type: "mysql"      # 非 MySQL 内省不到注释/枚举（建议 MySQL 上生成）
+    link: "..."
+
+# 菜单/字典等副作用还受定稿数据影响（parentMenuId 对应的菜单需存在）
+```
+
+## 多环境配置
+
+```text
+CLI 与服务读同一份 manifest/config/config.yaml：
+  本地生成 → 改本地配置
+  服务器上生成 → 改服务器配置（或 GF_ 环境变量覆盖不改文件）
+
+覆盖开关无环境变量特例时直接改配置文件（生成器为开发期工具，
+生产环境通常不部署生成需求）
+```
+
+## 配置实践建议
+
+```text
+日常开发：overwrite: false（保护手工扩展）
+新表首生成：保持 false 即可（文件不存在 = 全新写入）
+重新生成同表：
+  1. 先 false 生成看 Skipped 清单（了解哪些文件已有）
+  2. 有意覆盖的模块备份后临时 true
+  3. 生成后 diff 核对合并手工改动
+parentMenuId：团队约定统一挂载点（如"开发工具"分组）
+```