使用codegeex生成符合洋葱架构的go项目需四步:一、用精准提示词声明分层与依赖规则;二、分阶段生成并校验依赖方向;三、结合本地模板工程增强一致性;四、针对性修补越界导入、基础设施侵入等错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望使用CodeGeeX快速生成符合洋葱架构(Onion Architecture)规范的Go语言项目结构,但生成结果出现层间依赖错误、接口定义缺失或领域模型被基础设施污染等问题,则可能是由于提示词未准确表达架构约束或未引导模型分层建模。以下是实现该目标的具体方法:
一、使用精准提示词引导CodeGeeX生成分层结构
CodeGeeX依赖高质量提示词(prompt)触发其对架构模式的理解。洋葱架构要求严格遵循“依赖方向指向圆心”原则,即外层(如handlers、adapters)依赖内层(如domain、core),而内层不得引用外层。需在提示中显式声明层级边界与依赖规则。
1、在VSCode中打开一个空白Go文件,输入以下提示词:
2、“请生成一个符合洋葱架构的Go模块,包含domain(含实体、值对象、仓储接口)、application(含用例、DTO、错误类型)、infrastructure(含HTTP handler、数据库适配器实现)、interfaces(含API路由定义),所有包路径以‘/domain’、‘/application’等命名;domain层不导入任何其他层;application层可导入domain;infrastructure和interfaces层可导入application和domain;每个包提供一个README.md说明职责。”
3、按下Tab或Alt+Enter触发CodeGeeX补全,等待生成完整目录树及各层骨架代码。
二、分阶段生成并手动校验依赖方向
单次生成易导致跨层引用。应拆解为四阶段,每阶段生成后立即检查go.mod与import语句是否违反依赖倒置原则。此方法确保每一层仅依赖更内层,避免基础设施代码渗入核心。
1、先新建domain目录,输入提示:“定义Go domain层:包含User实体(ID string, Name string)、UserRepository接口(Save, FindByID)、DomainError自定义错误类型;不使用任何第三方包;输出完整.go文件。”
2、保存domain/user.go后,新建application目录,输入提示:“定义application层:包含CreateUserUseCase结构体(依赖UserRepository接口)、CreateUserInputDTO、CreateUserOutputDTO;不导入infrastructure或interfaces;仅导入domain。”
3、新建infrastructure/repository目录,输入提示:“实现domain.UserRepository接口:使用map模拟内存存储;命名为InMemoryUserRepository;导入domain包,不导入application或interfaces。”
4、新建interfaces/http目录,输入提示:“编写HTTP handler:接收JSON创建用户请求,调用application.CreateUserUseCase;导入application和domain,不导入infrastructure.repository以外的具体实现。”
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本,对Inline Chat功能进行了重大优化,包括UI设计升级、支持流式输出以提升响应速度,并新增“查看思路”按钮以便理解代码原理。同时,该版本在编辑器中新增CodeLens控件,支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
三、利用CodeGeeX插件+模板工程辅助生成
CodeGeeX支持加载本地模板文件作为上下文,提升生成一致性。将已验证的洋葱架构最小可行Go项目(含go.mod、Makefile、.gitignore及四层空包)设为模板,可显著减少越界导入。
1、在本地初始化一个标准洋葱结构空项目,确保go.mod中无外部框架强依赖(如gin、gorm仅出现在infrastructure层)。
2、在VSCode中打开该模板项目根目录,在任意.go文件中右键选择“CodeGeeX: Set Current File as Prompt Context”。
3、新建main.go,输入提示:“基于当前洋葱架构模板,为用户管理功能添加注册用例:接收邮箱与密码,生成User实体,保存至仓储,返回用户ID;保持domain纯度,不引入任何error wrapping工具或日志库。”
4、生成后立即运行go list -f '{{.Deps}}' ./... | grep -E '(infrastructure|interfaces)' | grep domain,确认domain包输出为空——这是验证内层未被外层反向引用的关键检查点。
四、修复常见生成错误的三类补丁操作
即使采用上述方法,CodeGeeX仍可能因训练数据偏差生成违反洋葱原则的代码,例如在domain层使用logrus、在application层直接调用http.Client。需针对性修补而非重写。
1、若domain层出现外部包导入:删除该import行,将相关行为上移至application或infrastructure层;若为错误处理,改用domain自有错误类型组合,如ErrInvalidEmail = errors.New("email format invalid")。
2、若application层直接实例化数据库连接:查找含sql.Open、gorm.Open等调用的代码,将其移至infrastructure/repository/xxx_impl.go,并通过构造函数注入到usecase中。
3、若interfaces层(如HTTP handler)返回了infrastructure层的具体错误(如pq.Error),必须替换为application层定义的错误映射函数,例如mapToAppError(err),且该函数必须定义在application/errors.go中,不得位于infrastructure内。










