0

0

基于Clean Architecture的Go项目架构实践

爱谁谁

爱谁谁

发布时间:2025-06-25 10:26:23

|

255人浏览过

|

来源于php中文网

原创

在过去的几年里,go语言已经在各个领域得到了广泛应用,从基础设施组件如k8s和docker,到业务领域的微服务,都可以使用go语言进行构建。在构建这些go项目时,选择哪种架构模式和代码布局是一个见仁见智的问题。有java spring经验的开发者可能会选择mvc模式,而有python flask经验的开发者可能会选择mtv模式。go语言领域尚未出现主流的企业级开发框架,许多项目甚至没有明确的架构模式。

Clean Architecture

基于Clean Architecture的Go项目架构实践Clean Architecture是Uncle Bob提出的适用于复杂业务系统的架构模式,其核心思想是将业务复杂度与技术复杂度解耦。与MVC、MTV等模式相比,Clean Architecture不仅进行分层,还通过依赖原则明确了与外部依赖的交互方式,以及外部依赖与业务逻辑的边界。感兴趣的朋友可以直接阅读作者原文:https://www.php.cn/link/95da0c581a96155640b7f98e422f9e44

由于Clean Architecture具有脱离语言和框架的灵活性,作者在提出时也没有规定实现细节,这给Clean Architecture的实际应用带来了挑战。接下来,我们将通过一个例子来说明如何在Go项目中应用Clean Architecture的思想。

布局

无论采用哪种架构模式,建议在Go项目中建立app和scripts两个目录。app目录用于存放启动Go项目的入口文件,通常是main.go。而scripts目录可以放置构建和部署时使用的脚本。

代码语言:javascript代码运行次数:0运行复制```javascript clean_architecture_demo├── README.md├── app│ └── main.go├── scripts│ ├── build.sh│ └── run.sh├── go.mod├── go.sum└── usecases

接下来是代码部分,分为entities、usecases、adapters三个部分。
  • entities:存储领域实体。以博客系统为例,领域实体可能包括用户(user)和文章(article)。

  • usecases:存储业务逻辑。以博客系统为例,可能包括与用户相关的业务逻辑(signup_user、signin_user、add_user、delete_user)和与文章相关的业务逻辑(add_article、show_article、delete_article)。

  • adapters:存储适配器逻辑。适配器是连接业务逻辑与外部依赖的层。如果博客系统通过Web形式提供服务,就需要一个http_adapter来封装Web服务;同时,如果需要将文章保存到数据库,则需要封装一个db_adapter来连接数据库。

以下是项目的布局结构。

代码语言:javascript代码运行次数:0http://www.w3.org/2000/svg"youjiankuohaophpcnzuojiankuohaophpcnpath d="M6.66666 10.9999L10.6667 7.99992L6.66666 4.99992V10.9999ZM7.99999 1.33325C4.31999 1.33325 1.33333 4.31992 1.33333 7.99992C1.33333 11.6799 4.31999 14.6666 7.99999 14.6666C11.68 14.6666 14.6667 11.6799 14.6667 7.99992C14.6667 4.31992 11.68 1.33325 7.99999 1.33325ZM7.99999 13.3333C5.05999 13.3333 2.66666 10.9399 2.66666 7.99992C2.66666 5.05992 5.05999 2.66659 7.99999 2.66659C10.94 2.66659 13.3333 5.05992 13.3333 7.99992C13.3333 10.9399 10.94 13.3333 7.99999 13.3333Z" fill="currentcolor">运行http://www.w3.org/2000/svg"youjiankuohaophpcnzuojiankuohaophpcnpath clip-rule="evenodd" d="M4.5 15.5V3.5H14.5V15.5H4.5ZM12.5 5.5H6.5V13.5H12.5V5.5ZM9.5 2.5H3.5V12.5H1.5V0.5H11.5V2.5H9.5Z" fill="currentcolor" fill-rule="evenodd">复制```javascript clean_architecture_demo├── README.md├── adapters│ ├── api│ ├── db│ └── log├── app│ └── main.go├── scripts│ ├── build.sh│ └── run.sh├── entities│ ├── article.go│ └── user.go├── go.mod├── go.sum└── usecases

数据流向

以查询文章的请求为例,描述一下调用链路。

mallcloud商城
mallcloud商城

mallcloud商城基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba并采用前后端分离vue的企业级微服务敏捷开发系统架构。并引入组件化的思想实现高内聚低耦合,项目代码简洁注释丰富上手容易,适合学习和企业中使用。真正实现了基于RBAC、jwt和oauth2的无状态统一权限认证的解决方案,面向互联网设计同时适合B端和C端用户,支持CI/CD多环境部署,并提

下载
  • 用户通过HTTP服务调用WebAdapter的ShowArticleHandler方法。

  • 由于这是文章相关的逻辑,ShowArticleHandler会调用ArticleUsecase的ShowArticle方法。

  • 需要从数据库中查询文章,ArticleUsecase会调用DBAdapter的GetArticle方法。

  • DBAdapter的GetArticle方法从MySQL中查询文章内容并返回给ArticleUsecase。

  • ArticleUsecase将结果返回给WebAdapter。

  • WebAdapter通过HTTP服务将结果返回给用户。

基于Clean Architecture的Go项目架构实践代码示例

为了更清晰地展示分层和架构,我在GitHub上发布了一个示例项目,感兴趣的朋友可以直接查看源码:https://www.php.cn/link/c1099cd51664559405dbb30d0f459df3

结论

由于Clean Architecture没有规定实现细节,因此上述的分层和布局方式只是一种参考,还有许多其他实践方式。例如,Adapter层可以根据外部依赖的类型细分为平行的Presenter+Gateway层。在复杂项目中,更细致的分层可以使代码更加细化。大家可以根据项目的规模来调整分层和布局,这里就不再赘述了。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

765

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

619

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1285

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 7.4万人学习

Git 教程
Git 教程

共21课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号