Go-Nunu框架使用指南：构建高效Go应用的完整教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00979/article/details/148890155

Go-Nunu框架使用指南：构建高效Go应用的完整教程

前言

Go-Nunu是一个基于Go语言的现代化应用框架，旨在帮助开发者快速构建高效、可靠的后端服务。本文将全面介绍如何使用Go-Nunu框架进行项目开发，从安装配置到核心功能实现，为开发者提供一站式解决方案。

框架安装与配置

安装步骤

要开始使用Go-Nunu，首先需要安装框架命令行工具：

go install github.com/go-nunu/nunu@latest

安装完成后，如果遇到命令未找到的情况，请检查系统环境变量中是否包含GOBIN路径。

项目初始化

创建新项目非常简单，只需执行以下命令：

nunu new project-name

框架提供两种项目模板供选择：

基础模板：适合熟悉框架的开发者，提供最简结构
高级模板（推荐）：包含丰富示例代码，适合学习和快速上手

对于国内开发者，可以使用国内镜像源加速项目创建：

# 使用基础模板
nunu new project-name -r https://gitee.com/go-nunu/nunu-layout-basic.git

# 使用高级模板
nunu new project-name -r https://gitee.com/go-nunu/nunu-layout-advanced.git

项目结构与核心概念

分层架构设计

Go-Nunu采用清晰的分层架构，主要包含以下组件：

Handler：处理HTTP请求和响应
Service：业务逻辑实现层
Repository：数据访问层
Model：数据模型定义

这种分层设计遵循了领域驱动设计(DDD)原则，使代码结构更加清晰，便于维护和扩展。

组件创建

框架提供了便捷的命令行工具来生成各个层级的组件：

# 创建单个组件
nunu create handler user
nunu create service user
nunu create repository user
nunu create model user

# 一次性创建所有组件
nunu create all user

也可以指定自定义路径创建组件：

nunu create handler internal/handler/user/center

项目运行与开发

启动项目

使用以下命令启动开发服务器：

nunu run

该命令支持热重载功能，修改代码后会自动重新编译运行。

依赖注入

Go-Nunu使用Google Wire实现依赖注入。编译wire.go文件：

nunu wire

配置管理

配置文件加载

框架使用Viper管理配置，默认加载config/local.yml文件。可以通过环境变量或命令行参数指定配置文件：

# Linux/Mac
APP_CONF=config/prod.yml nunu run

# Windows
set APP_CONF=config\prod.yml && nunu run

# 或使用参数方式
go run ./cmd/server -conf=config/prod.yml

配置示例

典型的数据库配置如下：

data:
  mysql:
    user: root:123456@tcp(127.0.0.1:3380)/user?charset=utf8mb4&parseTime=True&loc=Local
  redis:
    addr: 127.0.0.1:6350
    password: ""
    db: 0
    read_timeout: 0.2s
    write_timeout: 0.2s

在代码中通过依赖注入获取配置：

func NewDB(conf *viper.Viper) *gorm.DB {
    db, err := gorm.Open(mysql.Open(conf.GetString("data.mysql.user")), &gorm.Config{})
    if err != nil {
        panic(err)
    }
    return db
}

日志系统

Go-Nunu集成Zap日志库，提供高性能的日志记录功能。配置示例：

log:
  log_level: info
  encoding: json
  log_file_name: "./storage/logs/server.log"
  max_backups: 30
  max_age: 7
  max_size: 1024
  compress: true

在代码中使用日志：

h.logger.Info("GetUserByID", zap.Any("user", user))

数据库操作

GORM集成

框架默认使用GORM作为ORM工具。Repository层示例：

type UserRepository interface {
    FirstById(id int64) (*model.User, error)
}

type userRepository struct {
    *Repository
}

func (r *userRepository) FirstById(id int64) (*model.User, error) {
    var user model.User
    if err := r.db.Where("id = ?", id).First(&user).Error; err != nil {
        return nil, err
    }
    return &user, nil
}

接口编程实践

Go-Nunu强烈推荐使用面向接口编程，这带来了诸多优势：

提高代码灵活性，便于替换实现
增强可测试性，方便Mock测试
代码结构更清晰，职责更明确

测试策略

测试工具集成

框架支持多种测试工具：

testify：断言库
redismock：Redis Mock
gomock：接口Mock
go-sqlmock：数据库Mock

运行测试

执行测试并生成覆盖率报告：

go test -coverpkg=./internal/handler,./internal/service,./internal/repository -coverprofile=./.nunu/coverage.out ./test/server/...
go tool cover -html=./.nunu/coverage.out -o coverage.html

生成的HTML报告可以直观展示测试覆盖情况。