淺談Go 自建庫的使用教程與測試
更新時間：2025年09月05日 10:45:10 作者：qq_17280559
本文主要介紹了Go 自建庫的使用教程與測試,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧
附加一個Go庫的實(shí)現(xiàn)，相較于Python，Go的實(shí)現(xiàn)更較為日常，不需要額外增加setup.py類的文件去額外定義,計(jì)算和并發(fā)的性能更加。
1. 創(chuàng)建 Go 模塊項(xiàng)目結(jié)構(gòu)
首先創(chuàng)建完整的項(xiàng)目結(jié)構(gòu)：
gomathlib/ ├── go.mod ├── go.sum ├── core/ │ ├── arithmetic.go │ └── calculator.go ├── advanced/ │ ├── functions.go │ └── statistics.go ├── constants/ │ └── constants.go ├── examples/ │ ├── basic_usage.go │ └── advanced_usage.go ├── tests/ │ ├── core_test.go │ ├── advanced_test.go │ └── constants_test.go └── README.md
2. 初始化 Go 模塊
# 創(chuàng)建項(xiàng)目目錄 mkdir gomathlib cd gomathlib # 初始化 Go 模塊 go mod init github.com/yourusername/gomathlib # 創(chuàng)建目錄結(jié)構(gòu) mkdir -p core advanced constants examples tests
3. 核心代碼實(shí)現(xiàn)
3.1go.mod
module github.com/yourusername/gomathlib
go 1.21
require (
github.com/stretchr/testify v1.8.4
)
3.2core/arithmetic.go
package core
import (
"errors"
"math"
)
// Arithmetic 提供基礎(chǔ)算術(shù)運(yùn)算
type Arithmetic struct {
precision int
}
// NewArithmetic 創(chuàng)建新的算術(shù)運(yùn)算實(shí)例
func NewArithmetic(precision int) *Arithmetic {
return &Arithmetic{precision: precision}
}
// Add 加法運(yùn)算，支持多個參數(shù)
func (a *Arithmetic) Add(numbers ...float64) float64 {
var sum float64
for _, num := range numbers {
sum += num
}
return a.round(sum)
}
// Subtract 減法運(yùn)算
func (a *Arithmetic) Subtract(aVal, bVal float64) float64 {
return a.round(aVal - bVal)
}
// Multiply 乘法運(yùn)算，支持多個參數(shù)
func (a *Arithmetic) Multiply(numbers ...float64) float64 {
product := 1.0
for _, num := range numbers {
product *= num
}
return a.round(product)
}
// Divide 除法運(yùn)算
func (a *Arithmetic) Divide(dividend, divisor float64) (float64, error) {
if divisor == 0 {
return 0, errors.New("division by zero is not allowed")
}
return a.round(dividend / divisor), nil
}
// Power 冪運(yùn)算
func (a *Arithmetic) Power(base, exponent float64) float64 {
return a.round(math.Pow(base, exponent))
}
// Sqrt 平方根運(yùn)算
func (a *Arithmetic) Sqrt(number float64) (float64, error) {
if number < 0 {
return 0, errors.New("cannot calculate square root of negative number")
}
return a.round(math.Sqrt(number)), nil
}
// round 四舍五入到指定精度
func (a *Arithmetic) round(value float64) float64 {
if a.precision < 0 {
return value
}
shift := math.Pow(10, float64(a.precision))
return math.Round(value*shift) / shift
}
3.3core/calculator.go
package core
import (
"fmt"
"strings"
)
// Calculator 提供鏈?zhǔn)接?jì)算功能
type Calculator struct {
result float64
history []string
precision int
}
// NewCalculator 創(chuàng)建新的計(jì)算器實(shí)例
func NewCalculator(initialValue float64, precision int) *Calculator {
return &Calculator{
result: initialValue,
history: []string{fmt.Sprintf("Initial value: %.2f", initialValue)},
precision: precision,
}
}
// Add 加法操作
func (c *Calculator) Add(value float64) *Calculator {
c.result += value
c.history = append(c.history, fmt.Sprintf("+ %.2f", value))
return c
}
// Subtract 減法操作
func (c *Calculator) Subtract(value float64) *Calculator {
c.result -= value
c.history = append(c.history, fmt.Sprintf("- %.2f", value))
return c
}
// Multiply 乘法操作
func (c *Calculator) Multiply(value float64) *Calculator {
c.result *= value
c.history = append(c.history, fmt.Sprintf("* %.2f", value))
return c
}
// Divide 除法操作
func (c *Calculator) Divide(value float64) (*Calculator, error) {
if value == 0 {
return nil, fmt.Errorf("division by zero")
}
c.result /= value
c.history = append(c.history, fmt.Sprintf("/ %.2f", value))
return c, nil
}
// GetResult 獲取當(dāng)前結(jié)果
func (c *Calculator) GetResult() float64 {
// 使用內(nèi)置的round方法
shift := math.Pow(10, float64(c.precision))
return math.Round(c.result*shift) / shift
}
// Clear 清除計(jì)算歷史
func (c *Calculator) Clear() *Calculator {
c.result = 0
c.history = []string{"Cleared"}
return c
}
// GetHistory 獲取計(jì)算歷史
func (c *Calculator) GetHistory() []string {
return c.history
}
// String 返回計(jì)算歷史的字符串表示
func (c *Calculator) String() string {
return strings.Join(c.history, " → ")
}
3.4advanced/functions.go
package advanced
import (
"errors"
"math"
)
// MathFunctions 提供高級數(shù)學(xué)函數(shù)
type MathFunctions struct{}
// NewMathFunctions 創(chuàng)建新的數(shù)學(xué)函數(shù)實(shí)例
func NewMathFunctions() *MathFunctions {
return &MathFunctions{}
}
// Factorial 計(jì)算階乘
func (mf *MathFunctions) Factorial(n int) (int, error) {
if n < 0 {
return 0, errors.New("factorial is not defined for negative numbers")
}
if n == 0 {
return 1, nil
}
result := 1
for i := 1; i <= n; i++ {
result *= i
}
return result, nil
}
// IsPrime 判斷是否為質(zhì)數(shù)
func (mf *MathFunctions) IsPrime(n int) bool {
if n <= 1 {
return false
}
if n <= 3 {
return true
}
if n%2 == 0 || n%3 == 0 {
return false
}
for i := 5; i*i <= n; i += 6 {
if n%i == 0 || n%(i+2) == 0 {
return false
}
}
return true
}
// Fibonacci 生成斐波那契數(shù)列
func (mf *MathFunctions) Fibonacci(n int) ([]int, error) {
if n < 0 {
return nil, errors.New("n must be non-negative")
}
if n == 0 {
return []int{}, nil
}
if n == 1 {
return []int{0}, nil
}
if n == 2 {
return []int{0, 1}, nil
}
fib := make([]int, n)
fib[0] = 0
fib[1] = 1
for i := 2; i < n; i++ {
fib[i] = fib[i-1] + fib[i-2]
}
return fib, nil
}
// Log 計(jì)算對數(shù)
func (mf *MathFunctions) Log(number, base float64) (float64, error) {
if number <= 0 || base <= 0 || base == 1 {
return 0, errors.New("invalid arguments for logarithm")
}
return math.Log(number) / math.Log(base), nil
}
// Sin 計(jì)算正弦值（弧度）
func (mf *MathFunctions) Sin(radians float64) float64 {
return math.Sin(radians)
}
// Cos 計(jì)算余弦值（弧度）
func (mf *MathFunctions) Cos(radians float64) float64 {
return math.Cos(radians)
}
3.5advanced/statistics.go
package advanced
import (
"errors"
"math"
"sort"
)
// Statistics 提供統(tǒng)計(jì)計(jì)算功能
type Statistics struct{}
// NewStatistics 創(chuàng)建新的統(tǒng)計(jì)實(shí)例
func NewStatistics() *Statistics {
return &Statistics{}
}
// Mean 計(jì)算平均值
func (s *Statistics) Mean(numbers []float64) (float64, error) {
if len(numbers) == 0 {
return 0, errors.New("empty slice provided")
}
sum := 0.0
for _, num := range numbers {
sum += num
}
return sum / float64(len(numbers)), nil
}
// Median 計(jì)算中位數(shù)
func (s *Statistics) Median(numbers []float64) (float64, error) {
if len(numbers) == 0 {
return 0, errors.New("empty slice provided")
}
sorted := make([]float64, len(numbers))
copy(sorted, numbers)
sort.Float64s(sorted)
n := len(sorted)
if n%2 == 0 {
return (sorted[n/2-1] + sorted[n/2]) / 2, nil
}
return sorted[n/2], nil
}
// Mode 計(jì)算眾數(shù)
func (s *Statistics) Mode(numbers []float64) ([]float64, error) {
if len(numbers) == 0 {
return nil, errors.New("empty slice provided")
}
frequency := make(map[float64]int)
for _, num := range numbers {
frequency[num]++
}
maxFreq := 0
for _, freq := range frequency {
if freq > maxFreq {
maxFreq = freq
}
}
var modes []float64
for num, freq := range frequency {
if freq == maxFreq {
modes = append(modes, num)
}
}
return modes, nil
}
// StandardDeviation 計(jì)算標(biāo)準(zhǔn)差
func (s *Statistics) StandardDeviation(numbers []float64) (float64, error) {
if len(numbers) < 2 {
return 0, errors.New("at least two numbers required for standard deviation")
}
mean, err := s.Mean(numbers)
if err != nil {
return 0, err
}
sumSq := 0.0
for _, num := range numbers {
diff := num - mean
sumSq += diff * diff
}
variance := sumSq / float64(len(numbers)-1)
return math.Sqrt(variance), nil
}
// Variance 計(jì)算方差
func (s *Statistics) Variance(numbers []float64) (float64, error) {
if len(numbers) < 2 {
return 0, errors.New("at least two numbers required for variance")
}
mean, err := s.Mean(numbers)
if err != nil {
return 0, err
}
sumSq := 0.0
for _, num := range numbers {
diff := num - mean
sumSq += diff * diff
}
return sumSq / float64(len(numbers)-1), nil
}
3.6constants/constants.go
package constants
// MathConstants 包含常用數(shù)學(xué)常量
type MathConstants struct {
PI float64
E float64
GoldenRatio float64
EulerMascheroni float64
LightSpeed float64
}
// NewMathConstants 創(chuàng)建數(shù)學(xué)常量實(shí)例
func NewMathConstants() *MathConstants {
return &MathConstants{
PI: 3.14159265358979323846,
E: 2.71828182845904523536,
GoldenRatio: 1.61803398874989484820,
EulerMascheroni: 0.57721566490153286060,
LightSpeed: 299792458, // m/s
}
}
// 包級常量
var (
PI = 3.14159265358979323846
E = 2.71828182845904523536
GoldenRatio = 1.61803398874989484820
)
4. 使用教程
4.1 安裝依賴
# 下載依賴 go mod tidy # 或者手動安裝測試框架 go get github.com/stretchr/testify
4.2 基本使用示例examples/basic_usage.go
package main
import (
"fmt"
"log"
"github.com/yourusername/gomathlib/core"
"github.com/yourusername/gomathlib/advanced"
"github.com/yourusername/gomathlib/constants"
)
func main() {
fmt.Println("=== GoMathLib 基本使用示例 ===")
// 基礎(chǔ)算術(shù)運(yùn)算
arithmetic := core.NewArithmetic(4)
fmt.Println("\n1. 基礎(chǔ)運(yùn)算:")
fmt.Printf("加法: %.4f\n", arithmetic.Add(1.2345, 2.3456))
fmt.Printf("乘法: %.4f\n", arithmetic.Multiply(3, 4, 5))
result, err := arithmetic.Divide(22, 7)
if err != nil {
log.Fatal(err)
}
fmt.Printf("除法: %.4f\n", result)
// 鏈?zhǔn)接?jì)算器
fmt.Println("\n2. 鏈?zhǔn)接?jì)算器:")
calc := core.NewCalculator(10, 2)
calcResult, err := calc.Add(5).Multiply(3).Subtract(2).Divide(4)
if err != nil {
log.Fatal(err)
}
fmt.Printf("計(jì)算結(jié)果: %.2f\n", calcResult.GetResult())
fmt.Printf("計(jì)算歷史: %s\n", calcResult.String())
// 高級函數(shù)
fmt.Println("\n3. 高級函數(shù):")
mathFuncs := advanced.NewMathFunctions()
factorial, err := mathFuncs.Factorial(5)
if err != nil {
log.Fatal(err)
}
fmt.Printf("5的階乘: %d\n", factorial)
fmt.Printf("17是質(zhì)數(shù): %t\n", mathFuncs.IsPrime(17))
fib, err := mathFuncs.Fibonacci(10)
if err != nil {
log.Fatal(err)
}
fmt.Printf("斐波那契數(shù)列: %v\n", fib)
// 數(shù)學(xué)常量
fmt.Println("\n4. 數(shù)學(xué)常量:")
mathConsts := constants.NewMathConstants()
fmt.Printf("圓周率: %.10f\n", mathConsts.PI)
fmt.Printf("自然常數(shù)e: %.10f\n", mathConsts.E)
fmt.Printf("黃金比例: %.10f\n", mathConsts.GoldenRatio)
fmt.Printf("光速: %.0f m/s\n", mathConsts.LightSpeed)
}
5. 測試用例
5.1tests/core_test.go
package tests
import (
"testing"
"github.com/yourusername/gomathlib/core"
"github.com/stretchr/testify/assert"
)
func TestArithmetic(t *testing.T) {
arithmetic := core.NewArithmetic(4)
t.Run("Test Addition", func(t *testing.T) {
result := arithmetic.Add(1, 2, 3, 4)
assert.Equal(t, 10.0, result)
})
t.Run("Test Multiplication", func(t *testing.T) {
result := arithmetic.Multiply(2, 3, 4)
assert.Equal(t, 24.0, result)
})
t.Run("Test Division", func(t *testing.T) {
result, err := arithmetic.Divide(10, 2)
assert.NoError(t, err)
assert.Equal(t, 5.0, result)
})
t.Run("Test Division By Zero", func(t *testing.T) {
_, err := arithmetic.Divide(10, 0)
assert.Error(t, err)
})
t.Run("Test Precision", func(t *testing.T) {
result := arithmetic.Add(1.23456, 2.34567)
assert.Equal(t, 3.5802, result) // Rounded to 4 decimal places
})
}
func TestCalculator(t *testing.T) {
t.Run("Test Calculator Chain", func(t *testing.T) {
calc := core.NewCalculator(10, 2)
result, err := calc.Add(5).Multiply(3).Subtract(2).Divide(4)
assert.NoError(t, err)
assert.Equal(t, 9.75, result.GetResult())
})
t.Run("Test Calculator Division By Zero", func(t *testing.T) {
calc := core.NewCalculator(10, 2)
_, err := calc.Divide(0)
assert.Error(t, err)
})
t.Run("Test Calculator History", func(t *testing.T) {
calc := core.NewCalculator(0, 2)
calc.Add(5).Multiply(2)
history := calc.GetHistory()
assert.Len(t, history, 3) // Initial + Add + Multiply
})
}
5.2tests/advanced_test.go
package tests
import (
"testing"
"github.com/yourusername/gomathlib/advanced"
"github.com/stretchr/testify/assert"
)
func TestMathFunctions(t *testing.T) {
mathFuncs := advanced.NewMathFunctions()
t.Run("Test Factorial", func(t *testing.T) {
result, err := mathFuncs.Factorial(5)
assert.NoError(t, err)
assert.Equal(t, 120, result)
})
t.Run("Test Factorial Negative", func(t *testing.T) {
_, err := mathFuncs.Factorial(-1)
assert.Error(t, err)
})
t.Run("Test IsPrime", func(t *testing.T) {
assert.True(t, mathFuncs.IsPrime(2))
assert.True(t, mathFuncs.IsPrime(17))
assert.False(t, mathFuncs.IsPrime(1))
assert.False(t, mathFuncs.IsPrime(15))
})
t.Run("Test Fibonacci", func(t *testing.T) {
result, err := mathFuncs.Fibonacci(10)
assert.NoError(t, err)
expected := []int{0, 1, 1, 2, 3, 5, 8, 13, 21, 34}
assert.Equal(t, expected, result)
})
}
func TestStatistics(t *testing.T) {
stats := advanced.NewStatistics()
numbers := []float64{1, 2, 3, 4, 5, 5, 6}
t.Run("Test Mean", func(t *testing.T) {
result, err := stats.Mean(numbers)
assert.NoError(t, err)
assert.Equal(t, 3.7142857142857144, result)
})
t.Run("Test Median", func(t *testing.T) {
result, err := stats.Median(numbers)
assert.NoError(t, err)
assert.Equal(t, 4.0, result)
})
t.Run("Test Mode", func(t *testing.T) {
result, err := stats.Mode(numbers)
assert.NoError(t, err)
assert.Equal(t, []float64{5}, result)
})
t.Run("Test Empty Slice", func(t *testing.T) {
_, err := stats.Mean([]float64{})
assert.Error(t, err)
})
}
5.3tests/constants_test.go
package tests
import (
"testing"
"github.com/yourusername/gomathlib/constants"
"github.com/stretchr/testify/assert"
)
func TestConstants(t *testing.T) {
mathConsts := constants.NewMathConstants()
t.Run("Test PI", func(t *testing.T) {
assert.Equal(t, 3.14159265358979323846, mathConsts.PI)
assert.Equal(t, mathConsts.PI, constants.PI)
})
t.Run("Test E", func(t *testing.T) {
assert.Equal(t, 2.71828182845904523536, mathConsts.E)
assert.Equal(t, mathConsts.E, constants.E)
})
t.Run("Test GoldenRatio", func(t *testing.T) {
assert.Equal(t, 1.61803398874989484820, mathConsts.GoldenRatio)
assert.Equal(t, mathConsts.GoldenRatio, constants.GoldenRatio)
})
}
6. 運(yùn)行測試和示例
6.1 運(yùn)行測試
# 運(yùn)行所有測試 go test ./tests/ -v # 運(yùn)行特定測試 go test ./tests/ -run TestArithmetic -v # 運(yùn)行帶覆蓋率的測試 go test ./tests/ -cover -v # 生成HTML覆蓋率報(bào)告 go test ./tests/ -coverprofile=coverage.out go tool cover -html=coverage.out
6.2 運(yùn)行示例
# 運(yùn)行基本使用示例 go run examples/basic_usage.go # 構(gòu)建示例 go build -o examples/basic_usage examples/basic_usage.go ./examples/basic_usage
7. 發(fā)布和使用
7.1 在其他項(xiàng)目中使用
package main
import (
"fmt"
"github.com/yourusername/gomathlib/core"
"github.com/yourusername/gomathlib/advanced"
)
func main() {
// 使用算術(shù)運(yùn)算
math := core.NewArithmetic(2)
fmt.Printf("Result: %.2f\n", math.Add(1.23, 4.56))
// 使用高級函數(shù)
adv := advanced.NewMathFunctions()
isPrime := adv.IsPrime(29)
fmt.Printf("Is 29 prime? %t\n", isPrime)
}
7.2 在其他項(xiàng)目中引用
# 在其他Go項(xiàng)目中引用 go mod init myapp go mod edit -require github.com/yourusername/gomathlib@v0.1.0 go mod edit -replace github.com/yourusername/gomathlib=../gomathlib go mod tidy
8. 創(chuàng)建文檔
8.1 生成Godoc
# 啟動本地Godoc服務(wù)器 godoc -http=:6060 # 然后在瀏覽器訪問: http://localhost:6060/pkg/github.com/yourusername/gomathlib/
8.2README.md
# GoMathLib 一個功能強(qiáng)大的Go數(shù)學(xué)運(yùn)算庫，提供基礎(chǔ)運(yùn)算、高級函數(shù)和統(tǒng)計(jì)計(jì)算。 ## 安裝 ```bash go get github.com/yourusername/gomathlib
快速開始
package main
import (
"fmt"
"github.com/yourusername/gomathlib/core"
)
func main() {
math := core.NewArithmetic(2)
result := math.Add(1.23, 4.56)
fmt.Printf("Result: %.2f\n", result)
}
功能特性
- 基礎(chǔ)四則運(yùn)算
- 鏈?zhǔn)接?jì)算器
- 高級數(shù)學(xué)函數(shù)（階乘、質(zhì)數(shù)判斷、斐波那契數(shù)列）
- 統(tǒng)計(jì)計(jì)算（平均值、中位數(shù)、眾數(shù)、標(biāo)準(zhǔn)差）
- 數(shù)學(xué)常量
到此這篇關(guān)于淺談Go 自建庫的使用教程與測試的文章就介紹到這了,更多相關(guān)Go 自建庫使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
golang替換無法顯示的特殊字符(\u0000,?\000,?^@)
這篇文章主要介紹了golang替換無法顯示的特殊字符,包括的字符有\(zhòng)u0000,?\000,?^@等，下文詳細(xì)資料，需要的小伙伴可以參考一下2022-04-04
分頁是我們?nèi)粘ｉ_發(fā)中經(jīng)常會遇到的一個需求,下面這篇文章主要給大家介紹了關(guān)于如何通過go自定義一個分頁插件的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-03-03
性能優(yōu)化的前提是滿足正確可靠、簡潔清晰等質(zhì)量因素，針對?Go語言特性，本文為大家整理了一些Go語言相關(guān)的性能優(yōu)化建議，感興趣的可以了解一下2023-07-07
利用golang實(shí)現(xiàn)pdf中自動換行的表格
這篇文章主要給大家介紹了如何利用golang實(shí)現(xiàn)pdf中自動換行的表格,文中通過代碼示例給大家講解的非常詳細(xì),對大家的學(xué)習(xí)或工作有一定的幫助,需要的朋友可以參考下2024-02-02
編程中經(jīng)常遇到在一個流程中需要調(diào)用多個子調(diào)用的情況，此時就可以使用Go并發(fā)編程中的future模式，下面小編就來和大家聊聊future模式的具體使用，需要的可以參考一下2023-06-06
golang實(shí)現(xiàn)簡單的tcp數(shù)據(jù)傳輸
這篇文章主要為大家介紹了golang實(shí)現(xiàn)簡單的tcp數(shù)據(jù)傳輸，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-12-12
docker在開發(fā)和運(yùn)維中使用的場景越來越多,作為開發(fā)人員非常有必要了解一些docker的基本知識,而離我們工作中最近的也就是對應(yīng)用的docker部署編排了,這篇文章主要給大家介紹了關(guān)于golang使用DockerFile的正確用法指南,需要的朋友可以參考下2024-03-03
GoFrame實(shí)現(xiàn)順序性校驗(yàn)示例詳解
這篇文章主要為大家介紹了GoFrame實(shí)現(xiàn)順序性校驗(yàn)示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-06-06
golang實(shí)現(xiàn)PHP數(shù)組特性的方法
我們做業(yè)務(wù)過程中，對應(yīng)強(qiáng)類型語言使用有個痛點(diǎn)，就是使用變量之前一定要定義變量類型，那么本文就來介紹一下golang實(shí)現(xiàn)PHP數(shù)組特性的方法2021-12-12
golang中的下劃線表示忽略變量的意思，也沒有產(chǎn)生新的變量，但是后面的表達(dá)式依然會被執(zhí)行,本文為大家整理了golang中下劃線的一些不錯的用法，需要的可以參考下2023-05-05