PHP转GO Day3 函数定义与包管理实践（创建数学工具包）

Day3 函数定义与包管理实践（创建数学工具包）

---

数学工具包开发问题指南

---

一、标准包结构示例

# 项目结构（在GOPATH/src外新建目录）
my-math/
├── go.mod          # 模块定义文件
├── mathutil/       # 包目录
│   ├── math.go    # 包代码
│   └── math_test.go # 测试代码
└── main.go        # 使用示例

---

二、典型问题与解决方案

---

问题1：包导入路径错误

🛑 现象
import "mathutil" 提示 package mathutil not found
🔍 原因分析
未正确初始化模块或路径不规范
✅ 解决方案

# 在项目根目录执行（my-math为自定义模块名）
go mod init my-math

// main.go 正确导入方式
import "my-math/mathutil"  // 与go.mod模块名对应

---

问题2：函数不可见

🛑 现象
MathUtil.Add 不可访问
🔍 原因分析
函数名未大写开头（Go的导出规则）
✅ 解决方案

// math.go 修改前
func add(a, b int) int { ... }

// 修改后（首字母大写）
func Add(a, b int) int { ... }

---

问题3：依赖管理混乱

🛑 现象
go get 下载包速度慢或失败
🔍 原因分析
未配置国内镜像源
✅ 解决方案

# 配置GOPROXY（在项目根目录执行）
go env -w GOPROXY=https://goproxy.cn,direct

---

问题4：测试失败

🛑 现象
go test 显示找不到测试文件
🔍 原因分析
测试文件命名不规范或未在包目录
✅ 解决方案

# 正确测试文件命名
math_test.go  # 必须遵循 *_test.go 格式

# 执行测试（在mathutil目录下）
cd mathutil && go test -v

---

三、完整开发流程

---

步骤1：初始化模块

mkdir my-math && cd my-math
go mod init my-math

步骤2：创建包代码

// mathutil/math.go
package mathutil  // 包声明必须与目录名一致

// 公共函数（首字母大写）
func Add(a, b int) int {
    return a + b
}

// 私有函数（首字母小写）
func square(x int) int {
    return x * x
}

步骤3：编写测试

// mathutil/math_test.go
package mathutil

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("期望5，实际得到%d", result)
    }
}

步骤4：使用包

// main.go
package main

import (
    "fmt"
    "my-math/mathutil"  // 导入自定义包
)

func main() {
    sum := mathutil.Add(10, 20)
    fmt.Println("计算结果：", sum)
    
    // mathutil.square(5) // 错误！私有函数不可访问
}

---

四、PHP开发者特别注意

差异点	PHP实现	Go实现	关键提醒
包/命名空间	namespace Math;	package mathutil	Go包名必须匹配目录名
函数可见性	public function add()	首字母大写func Add()	Go没有显式可见性关键字
依赖安装	composer require	go get package-url	Go通过代码自动下载依赖
自动加载	composer autoload	无，必须显式导入	使用go mod tidy管理依赖

---

五、进阶问题处理

---

场景：需要第三方库

# 添加日志库（在项目根目录执行）
go get go.uber.org/zap

// 使用示例
import "go.uber.org/zap"

func main() {
    logger, _ := zap.NewProduction()
    logger.Info("开始计算", zap.Int("结果", mathutil.Add(5,3)))
}

场景：循环引用

错误提示：import cycle not allowed
解决方案：
1. 创建新包 `mathbase` 存放公共代码
2. 重构代码结构，避免双向依赖

---

六、验证清单

# 1. 编译检查
go build -v ./...

# 2. 运行测试
go test ./...

# 3. 执行示例
go run main.go

# 4. 依赖验证
go mod tidy  # 自动同步依赖

通过本指南，可快速定位包管理相关问题，建议使用VS Code的Go扩展自动处理大部分依赖问题。遇到复杂模块引用时，参考Go Modules官方文档进行深度排查。