Java 开发者第一次看 Go 代码，一般会被两件事搞懵：

1. 怎么没有 package com.xxx.xxx; 这种长路径？
2. import 的居然是 URL？

实际上，Go 的包（package）设计理念，和 Java 的“包 = 命名空间”有本质差异。

---

一、一句话核心区别

Java 的包是“逻辑命名空间”
Go 的包是“编译与发布的最小单元”

对比点	Java	Go
包的作用	命名空间、防冲突	编译单元、复用单元
包路径	与目录强绑定	与模块（module）绑定
导入方式	类级别	包级别
访问控制	public / protected	首字母大小写

---

二、包声明方式对比

Java：包名 ≈ 目录结构

package com.example.order.service;

• 一般必须和目录一一对应
• 主要解决命名冲突

---

Go：包名不等于目录名

package service

关键点：

• 包名只是一段标识符
• 不需要包含完整路径
• 同一目录下的 .go 文件 必须属于同一个包

Go 的包名更像是“逻辑能力集合”，而不是路径描述。

---

三、import 机制差异（重点）

Java：import 类

import java.util.List;
import java.util.ArrayList;

• 准确到 类
• IDE 自动补全
• JVM 运行期加载

---

Go：import 包

import (
    "fmt"
    "net/http"
)

• 只能导入包
• 不能只导入某个函数或类型
• 编译期决定

Go 的 import 是编译期依赖声明，不是运行期加载。

---

四、Go module vs Java Maven（关键认知）

Java（Maven）

<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>6.0.0</version>

• 坐标三元组
• 依赖传递复杂
• 强依赖仓库（Maven Central）

---

Go（go.mod）

module github.com/example/order

go 1.22

require (
    github.com/gin-gonic/gin v1.9.1
)

核心差异：

点	Java	Go
模块声明	pom.xml	go.mod
依赖下载	mvn	go mod
依赖版本	多版本共存	单版本原则

Go 天然避免“依赖地狱”。

---

五、包路径 = 代码位置 + module 前缀

假设：

module github.com/example/order

目录结构：

order
 ├── service
 │   └── order_service.go
 └── main.go

引用 service 包

import "github.com/example/order/service"

但在代码中使用的是：

service.CreateOrder()

import 路径 ≠ package 名称

---

六、访问控制：Go 比 Java 简单但更“狠”

Java

public
protected
default
private

---

Go：只有一条规则

首字母大写 = 对外可见

type OrderService struct {}   // public
type orderService struct {}   // private

func CreateOrder() {}         // public
func createOrder() {}         // private

• 不看修饰符
• 不看包路径
• 只看首字母

Java 开发者一开始会很不适应，但长期来看超级清晰。

---

七、别名导入（解决命名冲突）

Java

import java.sql.Date;
import java.util.Date;

---

Go

import (
    "database/sql"
    myjson "encoding/json"
)

使用：

myjson.Marshal(v)

---

八、匿名导入（Java 没有）

import _ "github.com/go-sql-driver/mysql"

作用：

• 只执行 init()
• 不直接使用包内容
• 常用于：
• JDBC Driver 类似场景
• 插件注册
• 框架自动发现

对 Java 开发者来说，≈ Class.forName(…)

---

九、init() 方法（隐藏但强劲）

func init() {
    fmt.Println("init")
}

特点：

• 每个包可有多个 init
• 自动执行
• 早于 main

⚠️ 提议：

• 框架可以用
• 业务代码慎用

---

十、Go 为什么禁止循环依赖？

Java：

A -> B
B -> A

能跑，但可维护性极差。

Go：

编译期直接报错

这也是 Go 包结构设计“被迫”更清晰的缘由。

---

十一、Java → Go 思维转变总结

Java 思维	Go 思维
包 = 命名空间	包 = 代码单元
import 类	import 包
多级路径表达语义	小包、清晰职责
访问控制靠修饰符	访问控制靠命名

一句话总结：

Java 用包“组织类型”
Go 用包“组织能力”