标签 命名 下的文章

Gopher视角:Java 开发者转向 Go 时,最需要“掰过来”的几个习惯

本文永久链接 – https://tonybai.com/2025/06/27/from-java-to-go

大家好,我是Tony Bai。

各位Gopher以及正在望向Go世界的Java老兵们,近些年,我们能明显感觉到一股从Java等“传统豪强”语言转向Go的潮流。无论是追求极致的并发性能、云原生生态的天然亲和力,还是那份独有的简洁与高效,Go都吸引了无数开发者。然而,从Java的“舒适区”迈向Go的“新大陆”,绝不仅仅是学习一套新语法那么简单,它更像是一场思维模式的“格式化”与“重装”

作为一名在Go语言世界摸爬滚打多年的Gopher,我见过许多优秀的Java开发者在初探Go时,会不自觉地带着一些“根深蒂固”的Java习惯。这些习惯在Java中或许是最佳实践,但在Go的语境下,却可能显得“水土不服”,甚至成为理解和掌握Go精髓的绊脚石。

今天,我就从Gopher的视角,和大家聊聊那些Java开发者在转向Go时,最需要刻意“掰过来”的几个习惯。希望能帮助大家更顺畅地融入Go的生态,体会到Go语言设计的精妙之处。

习惯一:接口的“名分”执念 -> 拥抱“能力”驱动

Java的习惯:

在Java世界里,接口(Interface)是神圣的。一个类要实现一个接口,必须堂堂正正地使用 implements 关键字进行声明,验明正身,告诉编译器和所有开发者:“我,某某类,实现了某某接口!” 这是一种名义类型系统(Nominal Typing)的体现,强调“你是谁”。

// Java
interface Writer {
    void write(String data);
}

class FileWriter implements Writer { // 必须显式声明
    @Override
    public void write(String data) {
        System.out.println("Writing to file: " + data);
    }
}

Go的转变:

Go语言则推崇结构化类型系统(Structural Typing),也就是我们常说的“鸭子类型”——“如果一个东西走起来像鸭子,叫起来像鸭子,那么它就是一只鸭子。” 在Go中,一个类型是否实现了一个接口,只看它是否实现了接口所要求的所有方法,无需显式声明。

更重要的是Go社区推崇的理念:“Define interfaces where they are used, not where they are implemented.”(在使用者处定义接口,而非实现者处)。

// Go
// 使用者(比如一个日志包)定义它需要的Write能力
type Writer interface {
    Write(data string) (int, error)
}

// 实现者(比如文件写入模块)
type FileWriter struct{}

func (fw *FileWriter) Write(data string) (int, error) {
    // ... 写入文件逻辑 ...
    fmt.Println("Writing to file:", data)
    return len(data), nil
}

// 无需声明 FileWriter 实现了 Writer,编译器会自动检查
// var w Writer = &FileWriter{} // 这是合法的

为什么要“掰过来”?

  1. 解耦大师:Go的隐式接口使得实现方和使用方可以完全解耦。使用方只关心“我需要什么能力”,而不关心“谁提供了这个能力,以及它还提供了什么其他能力”。这使得代码更加灵活,依赖关系更清晰。
  2. 测试的福音:你可以轻易地为你代码中的依赖定义一个小接口,并在测试中提供一个轻量级的mock实现,而无需修改被测试代码或依赖的原始定义。
  3. 避免臃肿接口:Java中常为了通用性设计出庞大的接口,而Go鼓励定义小而美的接口,按需取材。

Gopher建议

放下对 implements 的执念。在Go中,开始思考你的函数或模块真正需要依赖对象的哪些行为(方法),然后为这些行为定义一个小巧的接口。你会发现,代码的扩展性和可维护性瞬间提升。

习惯二:错误处理的“大包大揽” -> 转向“步步为营”

Java的习惯:

Java的 try-catch-finally 异常处理机制非常强大。开发者习惯于将可能出错的代码块包裹起来,然后在一个或多个 catch 块中集中处理不同类型的异常。这种方式的好处是错误处理逻辑相对集中,但有时也容易导致错误被“吞掉”或处理得不够精确。

// Java
public void processFile(String fileName) {
    try {
        // ... 一系列可能抛出IOException的操作 ...
        FileInputStream fis = new FileInputStream(fileName);
        // ... read from fis ...
        fis.close();
    } catch (FileNotFoundException e) {
        System.err.println("File not found: " + e.getMessage());
    } catch (IOException e) {
        System.err.println("Error reading file: " + e.getMessage());
    } finally {
        // ... 资源清理 ...
    }
}

Go的转变:

Go语言对错误处理采取了截然不同的策略:显式错误返回。函数如果可能出错,会将 error 作为其多个返回值中的最后一个。调用者必须(或者说,强烈建议)检查这个 error 值。

// Go
func ProcessFile(fileName string) error {
    file, err := os.Open(fileName) // 操作可能返回错误
    if err != nil {                // 显式检查错误
        return fmt.Errorf("opening file %s failed: %w", fileName, err)
    }
    defer file.Close() // 优雅关闭

    // ... use file ...
    _, err = file.Read(make([]byte, 10))
    if err != nil {
         // 如果是 EOF,可能不算真正的错误,根据业务处理
        if err == io.EOF {
            return nil // 假设读到末尾是正常结束
        }
        return fmt.Errorf("reading from file %s failed: %w", fileName, err)
    }
    return nil // 一切顺利
}

为什么要“掰过来”?

  1. 错误也是一等公民:Go的设计哲学认为错误是程序正常流程的一部分,而不是“异常情况”。显式处理让开发者无法忽视错误,从而写出更健壮的代码。
  2. 控制流更清晰:if err != nil 的模式使得错误处理逻辑紧跟在可能出错的操作之后,代码的控制流一目了然。
  3. 没有隐藏的“炸弹”:不像Java的checked exceptions和unchecked exceptions可能在不经意间“爆炸”,Go的错误传递路径非常明确。

Gopher建议

拥抱 if err != nil!不要觉得它啰嗦。这是Go语言深思熟虑的设计。学会使用 fmt.Errorf 配合 %w 来包装错误,形成错误链;学会使用 errors.Is 和 errors.As 来判断和提取特定错误。你会发现,这种“步步为营”的错误处理方式,能让你对程序的每一个环节都更有掌控感。

习惯三:包与命名的“层峦叠嶂” -> 追求“大道至简”

Java的习惯:

Java的包(package)名往往比较长,层级也深,比如 com.mycompany.project.module.feature。类名有时为了避免与SDK或其他库中的类名冲突,也会加上项目或模块前缀,例如 MyProjectUserService。这在大型项目中是为了保证唯一性和组织性。

// Java
// package com.mycompany.fantasticdb.client;
// public class FantasticDBClient { ... }

// 使用时
// import com.mycompany.fantasticdb.client.FantasticDBClient;
// FantasticDBClient client = new FantasticDBClient();

Go的转变:

Go的包路径虽然也可能包含域名和项目路径(例如 github.com/user/project/pkgname),但在代码中引用时,通常只使用包的最后一级名称。Go强烈建议避免包名和类型名“口吃”(stuttering)。比如,database/sql 包中,类型是 sql.DB 而不是 sql.SQLDB。

// Go
// 包声明: package fantasticdb (在 fantasticdb 目录下)
type Client struct { /* ... */ }

// 使用时
// import "github.com/mycompany/fantasticdb"
// client := fantasticdb.Client{}

正如附件中提到的,fantasticdb.Client 远比 FantasticDBClient 或 io.fantasticdb.client.Client 来得清爽和表意清晰(在 fantasticdb 这个包的上下文中,Client 自然就是指 fantasticdb 的客户端)。

为什么要“掰过来”?

  1. 可读性:简洁的包名和类型名让代码读起来更流畅,减少了视觉噪音。
  2. 上下文的力量:Go鼓励你信任包名提供的上下文。在 http 包里,Request 自然就是 HTTP 请求。
  3. 避免冗余:Go的哲学是“A little copying is better than a little dependency”,同样,一点点思考换来清晰的命名,好过冗余的限定词。

Gopher建议

在Go中,给包和类型命名时,思考“在这个包的上下文中,这个名字是否清晰且没有歧义?”。如果你的包名叫 user,那么里面的类型可以直接叫 Profile,而不是 UserProfile。让包名本身成为最强的前缀。

习惯四:代码复用的“继承衣钵” -> 推崇“灵活组装”

Java的习惯:

Java是典型的面向对象语言,继承(Inheritance)是实现代码复用和多态的核心机制之一。”is-a” 关系(比如 Dog is an Animal)深入人心。开发者习惯于通过构建复杂的类继承树来共享行为和属性。

Go的转变:

Go虽然有类型嵌入(Type Embedding),可以模拟部分继承的效果,但其核心思想是组合优于继承 (Composition over Inheritance)。”has-a” 关系是主流。通过将小的、专注的组件(通常是struct或interface)组合起来,构建出更复杂的系统。

// Go - 组合示例
type Engine struct { /* ... */ }
func (e *Engine) Start() { /* ... */ }
func (e *Engine) Stop() { /* ... */ }

type Wheels struct { /* ... */ }
func (w *Wheels) Rotate() { /* ... */ }

type Car struct {
    engine Engine // Car has an Engine
    wheels Wheels // Car has Wheels
    // ...其他组件
}

func (c *Car) Drive() {
    c.engine.Start()
    c.wheels.Rotate()
    // ...
}

为什么要“掰过来”?

  1. 灵活性:组合比继承更灵活。你可以动态地替换组件,或者为一个对象组合多种不同的行为,而无需陷入复杂的继承层级。
  2. 避免“猩猩/香蕉问题”:“你需要一个香蕉,但得到的是一只拿着香蕉的大猩猩,以及整个丛林。”继承有时会引入不必要的依赖和复杂性。组合则让你按需取用。
  3. 单一职责:组合鼓励你设计小而专注的组件,每个组件都做好一件事,这符合单一职责原则。

Gopher建议

当你试图通过继承来复用代码或扩展功能时,停下来想一想:我需要的是一个“is-a”关系,还是一个“has-a”关系?我是否可以通过将现有的小组件“塞”到我的新类型中来实现目标?在Go中,更多地使用类型嵌入(模拟组合)和接口来实现多态和行为共享。

小结:一场愉快的“思维升级”

从Java到Go,不仅仅是换了一套工具,更是一次编程思维的刷新和升级。初期可能会有些不适,就像习惯了自动挡再去开手动挡,总想不起来踩离合。但一旦你真正理解并接纳了Go的设计哲学——简洁、显式、组合、并发优先——你会发现一片全新的、更高效、也更富乐趣的编程天地。

上面提到的这几个“习惯”,只是冰山一角。Go的世界还有更多值得探索的宝藏。希望这篇文章能给你带来一些启发。

你从Java(或其他语言)转向Go时,还“掰过来”了哪些习惯?欢迎在评论区分享你的故事和心得!


你的Go技能,是否也卡在了“熟练”到“精通”的瓶颈期?

  • 想写出更地道、更健壮的Go代码,却总在细节上踩坑?
  • 渴望提升软件设计能力,驾驭复杂Go项目却缺乏章法?
  • 想打造生产级的Go服务,却在工程化实践中屡屡受挫?

继《Go语言第一课》后,我的《Go语言进阶课》终于在极客时间与大家见面了!

我的全新极客时间专栏 《Tony Bai·Go语言进阶课》就是为这样的你量身打造!30+讲硬核内容,带你夯实语法认知,提升设计思维,锻造工程实践能力,更有实战项目串讲。

目标只有一个:助你完成从“Go熟练工”到“Go专家”的蜕变! 现在就加入,让你的Go技能再上一个新台阶!


商务合作方式:撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求,请扫描下方公众号二维码,与我私信联系。

组织Golang代码

本月初golang官方blog(需要自己搭梯子)上发布了一篇文章,简要介绍了近几个月Go在一 些技术会议上(比如Google I/O、Gopher SummerFest等)的主题分享并伴有slide链接。其中David Crawshaw的“Organizing Go Code”对Golang的代码风格以及工程组 织的最佳实践进行的总结很是全面和到位,这里按Slide中的思路和内容翻译和摘录如下(部分伴有我个人的若干理解)。

一、包 (Packages)

1、Golang程序由package组成

所有Go源码都是包得一部分。

每个Go源文件都起始于一条package语句。

Go应用程序的执行起始于main包。

package main

import "fmt"

func main() {
    fmt.Println("Hello, world!")
}

对小微型程序而言,你可能只需要编写main包内的源码。

上面的HelloWorld程序import了fmt包。

函数Println定义在fmt包中。

2、一个例子:fmt包

// Package fmt implements formatted I/O.
package fmt

// Println formats using the default formats for its
// operands and writes to standard output.
func Println(a …interface{}) (n int, err error) {
    …
}

func newPrinter() *pp {
    …
}

Println是一个导出(exported)函数,它的函数名以大写字母开头,这意味着它允许其他包中的函数调用它。

newPrinter函数则并非导出函数,它的函数名以小写字母开头,它只能在fmt包内部被使用。

3、包的形态(Shape)

包是有关联关系的代码的集合,包规模可大可小,大包甚至可以横跨多个源文件。

同一个包的所有源文件都放在一个单一目录下面。

net/http包共由18个文件组成,导出了超过100个名字符号。

errors包仅仅由一个文件组成,并仅导出了一个名字符号。

4、包的命名

包的命名应该短小且有含义。
不要使用下划线,那样会导致包名过长;
不要过于概况,一个util包可能包含任何含义的代码;

    使用io/ioutil,而不是io/util
    使用suffixarray,而不是suffix_array

包名是其导出的类型名以及函数名的组成部分。

buf := new(bytes.Buffer)

仔细挑选包名

为用户选择一个好包名。

5、对包的测试

通过文件名我们可以区分出哪些是测试用源文件。测试文件以_test.go结尾。下面是一个测试文件的样例:

package fmt

import "testing"

var fmtTests = []fmtTest{
    {"%d", 12345, "12345"},
    {"%v", 12345, "12345"},
    {"%t", true, "true"},
}

func TestSprintf(t *testing.T) {
    for _, tt := range fmtTests {
        if s := Sprintf(tt.fmt, tt.val); s != tt.out {
            t.Errorf("…")
        }
    }
}

二、代码组织(Code organization)

1、工作区介绍(workspace)

你的Go源码被放在一个工作区(workspace)中。

一个workspace可以包含多个源码库(repository),诸如git,hg等。

Go工具知晓一个工作区的布局。

你无需使用Makefile,通过文件布局,我们可以完成所有事情。

若文件布局发生变动,则需重新构建。

$GOPATH/
    src/
        github.com/user/repo/
            mypkg/
                mysrc1.go
                mysrc2.go
            cmd/mycmd/
                main.go
    bin/
        mycmd

2、建立一个工作区

mkdir /tmp/gows
GOPATH=/tmp/gows

GOPATH环境变量告诉Go工具族你的工作区的位置。

go get github.com/dsymonds/fixhub/cmd/fixhub

go get命令从互联网网下载源代码库,并将它们放置在你的工作区中。

包的路径对Go工具来说很是重要,使用"github.com"意味着Go工具知道如何去获取你的源码库。

go install github.com/dsymonds/fixhub/cmd/fixhub

go install命令构建一个可执行程序,并将其放置在$GOPATH/bin/fixhub中。

3、我们的工作区

$GOPATH/
    bin/fixhub                              # installed binary
    pkg/darwin_amd64/                       # compiled archives
        code.google.com/p/goauth2/oauth.a
        github.com/…
    src/                                    # source repositories
        code.google.com/p/goauth2/
            .hg
            oauth                           # used by package go-github
            …
        github.com/
            golang/lint/…                 # used by package fixhub
                .git
            google/go-github/…            # used by package fixhub
                .git
            dsymonds/fixhub/
                .git
                client.go
                cmd/fixhub/fixhub.go        # package main

go get获取多个源码库。
go install使用这些源码库构建一个二进制文件。

4、为何要规定好文件布局

在构建时使用文件布局意味着可以更少的进行配置。

实际上,它意味着无配置。没有Makefile,没有build.xml。

在配置上花的时间少了,意味着在编程上可以花更多的时间。

Go社区中所有人都使用相同的布局,这会使得分享代码更加容易。

Go工具在一定程度上对Go社区的建设起到了帮助作用。

5、你的工作区在哪?

你可以拥有多个工作区,但大多数人只使用一个。那么你如何设置GOPATH这个环境变量呢?一个普遍的选择是:

GOPATH=$HOME

这样设置会将src、bin和pkg目录放到你的Home目录下。(这会很方便,因为$HOME/bin可能已经在你的PATH环境变量中了)。

6、在工作区下工作

CDPATH=$GOPATH/src/github.com:$GOPATH/src/code.google.com/p

$ cd dsymonds/fixhub
/tmp/gows/src/github.com/dsymonds/fixhub
$ cd goauth2
/tmp/gows/src/code.google.com/p/goauth2
$

将下面shell函数放在你的~/.profile中:

gocd () { cd `go list -f '{{.Dir}}' $1` }

$ gocd …/lint
/tmp/gows/src/github.com/golang/lint
$

三、依赖管理

1、在生产环境中,版本很重要

go get总是获取最新版本代码,即使这些代码破坏了你的构建。

这在开发阶段还好,但当你在发布阶段时,这将是一个问题。

我们需要其他工具。

2、版本管理

我最喜欢的技术:vendoring。

当构建二进制程序时,将你关心的包导入到一个_vendor工作区。
GOPATH=/tmp/gows/_vendor:/tmp/gows

注:
    1、在build时,我们通过构建脚本,临时修改GOPATH(GOPATH := ${PWD}/_vendor:${GOPATH}), 并将_vendor放置在主GOPATH前面,利用go build解析import包路径解析规则,go build优先得到_vendor下的第三方包信息,这样即便原GOPATH下有不同版本的相同第三方库,go build也会优先导入_vendor下的同名第三方库。
    2、go的相关工具在执行类似test这样的命令时会忽略前缀为_或.的目录,这样_vendor下的第三方库的test等操作将不会被执行。

当构建库时,将你关心的包导入你的源码库。重命名import为:
import "github.com/you/proj/vendor/github.com/them/lib"

长路径,不过对于自动化操作来说不算什么问题。写一个Go程序吧!

另外一种技术:gopkg.in。提供带版本的包路径:

gopkg.in/user/pkg.v3 -> github.com/user/pkg (branch/tag v3, v3.N, or v.3.N.M)

四、命名

1、命名很重要

程序源码中充满着各种名字。名字兼具代价和收益。

代价:空间与时间
    当阅读代码时,名字需要短时记忆
    你只能适应这么多,更长的名字需要占据更多的空间。

收益:信息
    一个好名字不仅仅是一个指代对象,它还能够传达某种信息。
    使用尽可能最短的名字用于在上下文中携带合理数量的信息。

在命名上花些时间(值得的)。

2、命名样式

使用camelCase,不要用下划线。

本地变量名字应该短小,通常由1到2个字符组成。

包名同行是一个小写词。

全局变量应该拥有长度更长的名字。

不要结巴!
 使用bytes.Buffer,不要用bytes.ByteBuffer
 使用zip.Reader,不要用zip.ZipReader
 使用errors.New,不要用errors.NewError
 使用r,不用bytesReader
 使用i,不用loopIterator

3、文档化注释

文档化注释放在导出标示符的声明之前:

// Join concatenates the elements of elem to create a single string.
// The separator string sep is placed between elements in the resulting string.
func Join(elem []string, sep string) string {

godoc工具可以解析出这些注释并将其展示在Web上:

func Join
    func Join (a []string, sep string) string

    Join concatenates the elements of  a to create a single string. The separetor string sep is placed between elements in the resulting string.

4、写文档化的注释

文档化的注释应用使用英文句子和段落。
除了为预定义格式进行的缩进外,没有其他特殊格式。

文档化注释应该以要描述的名词开头。

// Join concatenates…         good
// This function…             bad

包的文档应该放在包声明语句之前:

// Package fmt…
package fmt

在godoc.org上阅读Go世界的文档,比如:

godoc.org/code.google.com/p/go.tools/cmd/vet

如发现本站页面被黑,比如:挂载广告、挖矿等恶意代码,请朋友们及时联系我。十分感谢! Go语言第一课 Go语言进阶课 Go语言精进之路1 Go语言精进之路2 Go语言第一课 Go语言编程指南
商务合作请联系bigwhite.cn AT aliyun.com

欢迎使用邮件订阅我的博客

输入邮箱订阅本站,只要有新文章发布,就会第一时间发送邮件通知你哦!

这里是 Tony Bai的个人Blog,欢迎访问、订阅和留言! 订阅Feed请点击上面图片

如果您觉得这里的文章对您有帮助,请扫描上方二维码进行捐赠 ,加油后的Tony Bai将会为您呈现更多精彩的文章,谢谢!

如果您希望通过微信捐赠,请用微信客户端扫描下方赞赏码:

如果您希望通过比特币或以太币捐赠,可以扫描下方二维码:

比特币:

以太币:

如果您喜欢通过微信浏览本站内容,可以扫描下方二维码,订阅本站官方微信订阅号“iamtonybai”;点击二维码,可直达本人官方微博主页^_^:
本站Powered by Digital Ocean VPS。
选择Digital Ocean VPS主机,即可获得10美元现金充值,可 免费使用两个月哟! 著名主机提供商Linode 10$优惠码:linode10,在 这里注册即可免费获 得。阿里云推荐码: 1WFZ0V立享9折!


View Tony Bai's profile on LinkedIn
DigitalOcean Referral Badge

文章

评论

  • 正在加载...

分类

标签

归档



View My Stats