关于golang:Go-118-新特性多模块工作区教程让多模块开发变得简单

随着 2020 年 3 月 15 日 go 1.18 正式公布，新版本除了对性能的晋升之外，还引入了很多新性能，其中就有 go 期盼已久的性能泛型 (Generics)，同时还引入的多模块工作区(Workspaces) 和含糊测试(Fuzzing)。
对于泛型网上曾经有很多介绍的教程了，这里我介绍一个实用的性能，多模块工作区的应用办法和教程。
Go 多模块工作区可能使开发者可能更容易地同时解决多个模块的工作，如:

不便进行依赖的代码调试 (打断点、批改代码)、排查依赖代码 bug
不便同时进行多个仓库 / 模块并行开发调试

多模块工作区
开发流程演示
总结
参考文献

go 应用的是多模块工作区，能够让开发者更容易同时解决多个模块的开发。在 Go 1.17 之前，只能应用 go.mod replace 指令来实现，如果你正巧是同时进行多个模块的开发，应用它可能是很苦楚的。每次当你想要提交代码的时候，都不得不删除掉 go.mod 中的 replace 能力使模块稳固的公布版本。
在应用 go 1.18 多模块工作区性能的时候，就应用这项工作变得简略容易解决。上面我来介绍怎么应用这一性能。
Go 多模块工作区文档、代码示例获取地址 https://github.com/link1st/li…

首先咱们须要 go 1.18 或更高版本 go 装置

# 查看 go 版本
> go version
go version go1.18 darwin/amd64

`go work` 反对命令

通常状况下，倡议不要提交 go.work 文件到 git 上，因为它次要用于本地代码开发。
举荐在: $GOPATH 门路下执行，生成 go.work 文件
go work init 初始化工作区文件，用于生成 go.work 工作区文件

初始化并写入一个新的 go.work 到以后门路下，能够指定须要增加的代码模块
示例: go work init ./hello 将本地仓库 hello 增加到工作区
hello 仓库必须是 go mod 依赖治理的仓库(./hello/go.mod 文件必须存在)
go work use 增加新的模块到工作区

命令示例:
go work use ./example 增加一个模块到工作区
go work use ./example ./example1 增加多个模块到工作区
go work use -r ./example 递归 ./example 目录到当前工作区
删除命令应用 go work edit -dropuse=./example 性能
go work edit 用于编辑 go.work 文件

能够应用 edit 命令编辑和手动编辑 go.work 文件成果是雷同的
示例:
go work edit -fmt go.work 从新格式化 go.work 文件
go work edit -replace=github.com/link1st/example=./example go.work 替换代码模块
go work edit -dropreplace=github.com/link1st/example 删除替换代码模块
go work edit -use=./example go.work 增加新的模块到工作区
go work edit -dropuse=./example go.work 从工作区中删除模块
go work sync 将工作区的构建列表同步到工作区的模块
go env GOWORK

查看环境变量，查看当前工作区文件门路
能够排查工作区文件是否设置正确，go.work 门路找不到能够应用 GOWORK 指定

> go env GOWORK
$GOPATH/src/link1st/link1st/workspaces/go.work

文件构造和 go.mod 文件构造相似，反对 Go 版本号、指定工作区和须要替换的仓库
文件构造示例:

go 1.18

use (
    ./hello
    ./example
)

replace (github.com/link1st/example => ./example1)

`use` 指定应用的模块目录

能够应用 go work use hello 增加模块，也能够手动批改 go.work 工作区增加新的模块
在工作区中增加了模块门路，编译的时候会主动应用 use 中的本地代码进行代码编译，和 replaces 性能相似。

# 单模块构造
use ./hello

# 多模块构造
use (
    ./hello
    ./example
)

`replaces` 替换依赖仓库地址

replaces 命令与 go.mod 指令雷同，用于替换我的项目中依赖的仓库地址
须要留神的是 replaces 和 use 不能同时指定雷同的本地门路

同时指定报错信息:
go: workspace module github.com/link1st/example is replaced at all versions in the go.work file. To fix, remove the replacement from the go.work file or specify the version at which to replace the module.

谬误示例

同时在 use 和 replace 指定雷同的本地门路

go 1.18

use (
    ./hello
    ./example
)

replace (github.com/link1st/example => ./example)

go.work 文件优先级高于 go.mod 中定义

在同时应用 go.work 和 go.mod replace 性能的的时候别离指定不同的代码仓库门路，go.work 优先级高于 go.mod 中定义

go.mod 中定义替换为本地仓库 example

replace (github.com/link1st/example => ./example1)

go.work 中定义替换为本地仓库 example1

replace (github.com/link1st/example => ./example1)

在代码构建时候应用的是 go.work 指定的 example1 仓库的代码，go.work 优先级别更高

在 Go 1.18 go run 和 go build 都会默认应用工作区性能
GOWORK 也能够指定配置 go.work 文件地位

export GOWORK="~/go/src/test/go.18/workspace/go.work"

Go 全局变量 GOWORK 设置 off 则能够禁用工作区性能

export GOWORK=off

演示如何应用多模块工作区性能。在当初微服务流行的年代，一个人会保护多个代码仓库，很多的时候是多个仓库进行同时开发
假如咱们当初进行 hello 仓库开发，实现的性能是，实现将输出的字符串反转并输入，字符串反转性能依赖于 github.com/link1st/example (下文统称 example)公共仓库实现
新建 hello 我的项目

mkdir hello
cd hello
# 代码仓库启动 go mod 依赖治理，生成 go.mod 文件
go mod init github.com/link1st/link1st/workspaces/hello
# 下载依赖包
go get github.com/link1st/example
# 编写 main 文件
vim main.go

main.go 代码

// Package main main 文件，go 多模块工作区演示代码
// 实现将输出的字符串反转输入并输入
package main

import (
    "flag"
    "fmt"

    "github.com/link1st/example/stringutil"
)

var (str = "")

func init() {flag.StringVar(&str, "str", str, "输出字符")
    flag.Parse()}

func main() {
    if str == "" {fmt.Println("示例: go run main.go -str hello")
        fmt.Println("str 参数必填")
        flag.Usage()
        return
    }

    // 调用公共仓库，进行字符串反转
    str = stringutil.Reversal(str)
    // 输入反转后的字符串
    fmt.Println(str)
    return
}

运行代码 go run main.go -str "hello world" 或 go run github.com/link1st/link1st/workspaces/hello -str "hello world" 能够看到输入了 hello world 反转当前的字符串

> go run main.go -str "hello world"
dlrow olleh

到这里，最后的性能曾经实现，然而后续需要变动，不仅须要输入反转当前的字符串，还须要将字符串大写
咱们则须要去 example 仓库中增加开发 将字符串大写的性能

# 回到工作根目录，将 common 代码下载到本地进行增加新的性能
# 下载依赖的 example 包
git clone git@github.com:link1st/example.git
# 在 example 包中增加 字符串大学的性能

vim example/stringutil/to_upper.go 代码如下

// Package stringutil stringutil
package stringutil

import ("unicode")

// ToUpper 将字符串进行大写
func ToUpper(s string) string {r := []rune(s)
    for i := range r {r[i] = unicode.ToUpper(r[i])
    }
    return string(r)
}

因为代码还在本地调试，未提交 git 仓库中，这个时候就须要用到 Go 多模块工作区的性能了。
进入我的项目根目录，初始化咱们当初正在开发的模块

# 初始化 go.work 文件
go work init  ./hello ./example
# 查看 go.work 文件内容
cat go.work

文件构造如下

go 1.18

use (
    ./example
    ./hello
)

回到 hello 我的项目，vim main.go 将字符串大写的性能增加上。

func main() {
    ...

    // 调用公共仓库，进行字符串反转
    str = stringutil.Reversal(str)
    // 减少字符大写的性能
    str = stringutil.ToUpper(str)
    // 输入反转后的字符串
    fmt.Println(str)
    
    ...
}

运行代码

能够看到输入了反转并大写的字符串，大写的函数性能只在本地，未提交到 git 上，这样咱们就实现了能够同时在两个模块上并行开发

go run main.go -str "hello world"
DLROW OLLEH

到这里，演示的代码曾经全副实现

应用 Go 多模块工作区的性能，能够让咱们轻松在多个模块之间切换工作，更能适应古代微服务架构开发。

Go 1.18 新个性多模块工作区教程

Go 1.18 is released!

Tutorial: Getting started with multi-module workspaces

go-1.18-features

关于golang:Go-118-新特性多模块工作区教程让多模块开发变得简单

导读

目录

多模块工作区

阐明

应用条件

`go work` 反对命令

go.work 文件构造

`use` 指定应用的模块目录

`replaces` 替换依赖仓库地址

go.work 文件优先级高于 go.mod 中定义

如何应用

如何禁用工作区

开发流程演示

总结

参考文献

Just My Socks（注册教程内含优惠码）

关于golang:Go-118-新特性多模块工作区教程让多模块开发变得简单

导读

目录

多模块工作区

阐明

应用条件

go work 反对命令

go.work 文件构造

use 指定应用的模块目录

replaces 替换依赖仓库地址

go.work 文件优先级高于 go.mod 中定义

如何应用

如何禁用工作区

开发流程演示

总结

参考文献

Just My Socks（注册教程 内含优惠码）

`go work` 反对命令

`use` 指定应用的模块目录

`replaces` 替换依赖仓库地址

Just My Socks（注册教程内含优惠码）