gii 必须手动启用且严格按序配置才能使用：先确保 yii_env='dev'，再在 main-local.php 中解禁 gii 模块并设置 allowedips（如 ['127.0.0.1', '::1']），最后通过 /gii 访问；跳过任一环节将导致 403 或资产发布失败。
Gii 不是开箱即用的工具，必须手动启用、配对权限、按顺序生成，跳过任一环节都会报错或生成失败。
怎么在 Yii2 中启用 Gii 模块
默认情况下 Gii 只在开发环境注册，但高级模板里它常被注释掉，不主动打开就完全不可见。关键不是“装”，而是“解禁”。
- 找到
frontend/config/main-local.php（前端）或backend/config/main-local.php（后台），确保modules数组里有'gii' => ['class' => 'yii\gii\Module'] -
allowedIPs必须显式设置，不能留空或写成['*']，否则访问/gii会直接返回 403；本地开发建议设为['127.0.0.1', '::1'] - 如果用 Docker 或远程开发机，
allowedIPs要填宿主机真实 IP（比如192.168.1.100），而不是容器内网地址
Model Generator 生成模型时常见报错
最常卡在表名识别和命名空间上，错误信息往往只显示 “Table not found”，但实际原因五花八门。
-
Table Name必须跟数据库里实际表名**完全一致**（含前缀、大小写），MySQL 默认忽略大小写，但 PostgreSQL 和 SQLite 区分，user和User是两个表 - 若提示
Class 'app\models\User' already exists，不是覆盖问题，而是你没点Preview就直接Generate，而文件已存在且未勾选Overwrite -
Generate Relations勾选后，Gii 会扫描外键约束；如果数据库没建外键（比如只靠约定关联），关系不会自动生成，别误以为功能失效
CRUD Generator 为什么生成的控制器不能访问
生成成功 ≠ 能运行。Gii 只写代码，不改路由、不配权限、不处理已有逻辑冲突。
- 生成的
UserController默认继承yii\web\Controller，但如果你项目中全局要求登录（比如behaviors()里强制access），而没在生成器里配置Enable I18N或补全access()规则，访问/user/index会直接跳登录页或 403 -
View Path填@app/views/user是对的，但如果@app别名没正确定义（比如在 console 环境下运行 web 的 Gii），路径解析会失败，生成的视图文件可能被写到错目录 - 不要用 Gii 重复生成同一个控制器——它不会合并方法，而是直接覆盖整个文件，已加的自定义 action（如
actionExport）会被清空
命令行调用 Gii 有哪些限制
官方文档提得少，但实际使用中容易踩坑：它不走 Web 权限校验，但依赖完整应用上下文，不是所有环境都能跑通。
- 必须在
yii入口脚本所在目录执行，比如php yii gii/model --tableName=user，否则找不到模块类 - 命令行模式下
allowedIPs不生效，但db组件必须已正确配置，否则连不上库，报错是Unknown Component ID: db - 生成的文件编码、换行符、PHP 版本兼容性由当前 CLI PHP 决定，如果服务器 PHP 是 7.4，而本地是 8.2，生成的属性类型声明（如
public int $id）可能运行时报错
真正卡住人的从来不是按钮点几下，而是数据库连接是否通、命名空间是否拼错、allowedIPs 是否匹配当前请求来源这三处——查日志前先盯死它们。
