脚本之家,脚本语言编程技术及教程分享平台!
分类导航

Python|VBS|Ruby|Lua|perl|VBA|Golang|PowerShell|Erlang|autoit|Dos|bat|shell|

服务器之家 - 脚本之家 - Golang - Go 透明文件夹的特性,有没有必要加?

Go 透明文件夹的特性,有没有必要加?

2023-11-07 18:59脑子进煎鱼了 Golang

如果盲目的添加透明文件夹,反而会出现一个尴尬的问题。因为 Go 语言在这块是非常直接的,添加了这类模式,大家反而会没法笃定,要去看看项目的代码结构才能确定。

大家好,我是煎鱼。

在 Go 语言中,我们一般会用模块(Module)和包(Package)来组织我们的项目、库的目录和代码结构。这也是官方所推荐的。

今天给大家分享一个面向包这块的新提案,看看是否合适加进 Go 特性中?看看社区里不同人的想法。

前置知识:模块和包

具体来讲,模块(Module)就是 go mod 的应用。我们最常接触到的是以下命令:

mkdir my-project
cd my-project
go mod init github.com/eddycjy/my-project

在执行了 go mod init 后会生成 go.mod 文件,如下所示:

// go.mod
module github.com/eddycjy/my-project

go 1.21.1

这就是这个项目的模块。

对应到包(Package)中,会更加的直接和显性。我们一般会创建类似如下的目录结构:


  -
    --cli.go
  -
    --internals.go
  --go.mod
  --main.go

Go 文件中的 package name,存在明确的约定俗成的标准,需要和目录名称保持一致。

例如:

// internals.go
package internals

import "fmt"

func Hello() {
 fmt.Println("你好,煎鱼!")
}

如果在其他地方中导入该包,则为:

import (
 ...
 "github.com/eddycjy/my-project/internals"
)

以上就是模块和包的基础前置知识。我们接下来正式进入提案的正题。

提案:透明文件夹

针对 Go 程序的代码组织结构管理,最近社区有个同学提出了一个新提案:

Go 透明文件夹的特性,有没有必要加?图片

在 Go 里文件夹默认与包(Package)的关系是划等号的。虽然这很方便,但是提案作者反馈:在某些情况下,我们需要通过文件夹来实现纯粹的组织和可读性目的,而不想引入新的包。

为此提出了 “透明文件夹” 的概念,通过使用诸如 Next.js 应用程序路由器中看到的 (folder) 或 _folder 之类的语义来表示。

这些文件夹可以在不创建新软件包的情况下组织软件包内的文件。它们将与软件包的根目录保持关系。

例子如下:

myapp
  main.go
  myTypes.go
  (routes)
     handleRoot.go
     handleMultipart.go
     ...
  db
     connect.go
     dbTypes.go
     (auth)
         strategy1.go
         strategy2.go
         ...

可以看到这个例子,他使用 (folder) 的方式来表示透明文件夹。例如:(routes) 和 (auth),这样他就不需要再细分不同的 package name,统一用 myapp 和 db 的包名就能进行引用。

简单来讲,该提案的实现方式是:通过将工程中 package name 和实体文件夹目录的作用分割开,目的是:提供一种纯粹的代码组织方式。

一些争议

其实类似的场景诉求,我有一个朋友曾经听几个同事吐槽过。但一般会是在比较大的 Go 项目中,例如出现以下场景:

myapp
  service
    a-service
    b-service
    c-service
    ...

会认为这样 package 切割的比较碎,但是不区分开。多了后在代码结构上又很容易繁杂化。所以会想有一种纯碎的代码组织方式。

争议也是有不少的。因为他对语言的 ROI 并不是太高,变动的东西(例如:工具、IDE、tests 等)会比较多。

只需将文件命名为:aaa-foo.go aaa-bar.go bbb-foo.go bbb-bar.go,而不是 aaa/foo.go aaa/bar.go bbb/foo.go bbb/bar.go。也能达到类似的效果。

也有表示添加透明子文件夹会让一切变得更加复杂,却没有任何好处。把文件放在它们应该在的地方就可以了。现在已经在其他语言中看到过这种替代方法,很糟糕。

总结

这个提案本身的出发点很常见,因为 package name 和代码目录结构绑定了,会导致在设计代码结构时会有些受限,最终受此引导拆 package 来形成结构化。

如果盲目的添加透明文件夹,反而会出现一个尴尬的问题。因为 Go 语言在这块是非常直接的,添加了这类模式,大家反而会没法笃定,要去看看项目的代码结构才能确定。

我认为反而会导致可读性会有所下降。

原文地址:https://mp.weixin.qq.com/s/pYgV9F0qMTcSKXlgTzfSKw

延伸 · 阅读

精彩推荐
  • GolangGo归并排序算法的实现方法

    Go归并排序算法的实现方法

    归并排序采用的也是分治的策略,把原本的问题先分解成一些小问题进行求解,再把这些小问题各自的答案修整到一起得到原本问题的答案,从而达到分而...

    KevinYan118042022-09-13
  • Golanggo语言实现sftp包上传文件和文件夹到远程服务器操作

    go语言实现sftp包上传文件和文件夹到远程服务器操作

    这篇文章主要介绍了go语言实现sftp包上传文件和文件夹到远程服务器操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...

    奔流入海17762021-03-06
  • Golang浅谈Go语言的空标示符

    浅谈Go语言的空标示符

    本文通过文字及实例介绍了Go语言的空标示符,对此有不明白的朋友可以参考学习,下面一起来看看吧。 ...

    daisy4632020-05-01
  • Golanggo mod 使用旧版本 版本号指定方式

    go mod 使用旧版本 版本号指定方式

    这篇文章主要介绍了go mod 使用旧版本 版本号指定方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...

    gs801406242021-06-24
  • Golanggolang gorm多条件筛选查询操作

    golang gorm多条件筛选查询操作

    这篇文章主要介绍了golang gorm多条件筛选查询操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧 ...

    疯狂的鸭血12212021-03-09
  • GolangGo中使用gjson来操作JSON数据的实现

    Go中使用gjson来操作JSON数据的实现

    本文主要介绍了Go中使用gjson来操作JSON数据,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着...

    乔克4122022-08-14
  • GolangGo 语言的函数与指针

    Go 语言的函数与指针

    函数就是一段基本的代码块,一般用来对需要重复执行的代码进行复用。在 go 中,函数是『一等公民』,这与 js 类似,也就是可以将函数当做一个变量进...

    自然醒的笔记本11072021-04-14
  • Golanggolang简单位运算示例

    golang简单位运算示例

    这篇文章主要介绍了golang简单位运算,包括位移运算、取反及位与位或等运算,需要的朋友可以参考下 ...

    脚本之家4912020-04-29