面向Java程序员的Go工程开发入门流程

your_app_name/├── cmd/│   ├── your_app_name/            # 应用程序的入口点，包含main包│   │   └── main.go               # 应用程序的主函数所在│   └── ...                       # 如果有多个可执行文件，可以在这里添加├── internal/                     # 可选，存放仅供本应用内部使用的包│   └── ...                       # 内部包结构，比如业务逻辑、工具函数等├── config/                       # 配置文件或配置加载逻辑│   └── ...                       # 如yaml, toml, env等配置文件├── scripts/                      # 构建、部署脚本等│   └── ...                       ├── tests/                        # 单元测试、集成测试等│   └── ...                       ├── README.md                     # 项目说明文档├── go.mod                        # Go模块定义文件├── go.sum                        # Go模块依赖的校验和文件├── .gitignore                    # Git忽略规则文件└── ...                           # 其他必要的文件，如Dockerfile、Makefile等

your_library_name/├── internal/                      # 可选，用于存放不希望对外暴露的包│   └── ...                        # 内部使用的包├── pkg/                           # 存放库的公开对外接口。pkg 这一层可以省略，直接把源代码放在/your_library_name 目录下│   └── your_library_name/│       ├── your_library.go│       └── ...                    # 库的各个源文件├── tests/                        # 单元测试、集成测试等│   └── ...                       ├── README.md                      # 项目说明文档，包括安装、使用方法等├── go.mod                         # Go模块定义文件├── go.sum                         # Go模块的校验和文件├── .gitignore                     # Git忽略文件列表└── ...                            # 其他必要的文件，如Dockerfile、Makefile等

module github.com/dapr/dapr^^^ 声明该模块的名字，类似于 groupId:artifactId    强烈建议在这里填写这个工程的实际可访问的git地址，否则会带来无穷无尽的麻烦
go 1.21^^^ 指定要求的最低 go 版本，类似于 <java.version>1.8</java.version>
require (^^^ 这里列出所有直接依赖项，类似于 <dependencies>
    contrib.go.opencensus.io/exporter/prometheus v0.4.2    github.com/PaesslerAG/jsonpath v0.1.1    github.com/PuerkitoBio/purell v1.2.1)
require (^^^ 这一大片后面带有 // indirect 的是 go 自动生成的所有间接依赖，类似 mvn dependency:tree 的产出。    千万不要手工修改这部分。
    cloud.google.com/go v0.110.10 // indirect    cloud.google.com/go/compute v1.23.3 // indirect    cloud.google.com/go/compute/metadata v0.2.3 // indirect    cloud.google.com/go/datastore v1.15.0 // indirect    cloud.google.com/go/iam v1.1.5 // indirect)
replace (^^^ 这一段用于模块的名称和实际 git 地址不匹配的情况。    上面提到的无穷无尽的麻烦就是指，所有引用你的包的项目都需要使用 replace 来将你的包指向实际的 git 地址
    github.com/toolkits/concurrent => github.com/niean/gotools v0.0.0-201512
    replace github.com/dapr/components-contrib => ../components-contrib    ^^^ 也可以将模块的路径指向本地，以便于二方包开发过程中进行调试)

import (    "github.com/go-playground/validator/v10")...func foo() {    validator.Xxx()}

import (    validator "github.com/go-playground/validator/v10")

if false {    validator.Xxx() // 不要直接注掉，免得ide把对应的import语句也给删了}

require gitlab.mycompany.com/${groupId}/${artifactId} v0.0.0-notexistreplace gitlab.mycompany.com/${groupId}/${artifactId} => gitlab.mycompany.com/${groupId}/${artifactId} v0.0.0-${branch}

require gitlab.mycompany.com/shop/libaaa v0.0.0-notexistreplace gitlab.mycompany.com/shop/libaaa => gitlab.mycompany.com/shop/libaaa v0.0.0-develop2

沧海月明珠有泪，蓝田日暖玉生烟。此情可待成追忆，只是当时已惘然。            —— （唐）李商隐

# 定义一些常量APPNAME := your_application_nameBINDIR := /build/binGOBIN := $(shell go env GOPATH)/binexport GO111MODULE := on
# 目标: 清理clean:  @rm -rf $(BINDIR)/*  @echo "Cleanup completed."
# 目标: 构建build: go_mod_tidy compile
# 执行go mod tidygo_mod_tidy:  @go mod tidy  @echo "go mod tidy completed."
# 编译项目compile:   @mkdir -p $(BINDIR)  @go build -o $(BINDIR)/${APPNAME}  @echo "Build completed."
# 使用帮助信息help:  @echo "Usage:"  @echo "make build - 整理模块依赖，编译项目，将产出物放到 /build/bin 目录下"  @echo "make clean - 清理构建产物"
.PHONY: clean build go_mod_tidy compile help

{    "version": "0.2.0",    "configurations": [        {            "name": "Launch Go Program with Args",            "type": "go",            "request": "launch",            "mode": "debug",            "program": "${fileDirname}", // 当前文件所在的目录作为工作目录，如果你需要指定特定的可执行文件路径，可以改为该路径            "args": ["arg1", "arg2", "--option=value"], // 在这里添加你的命令行参数            "env": {"env1":"env_value1", "env2":"env_value2"}, // 可以在这里添加环境变量，如果需要            "showLog": true, // 是否在调试控制台显示Delve的日志，默认为false            "trace": "verbose" // 设置为"verbose"可以获取更详细的调试信息，根据需要调整        }    ]}