Protocol Buffers的扩展工具：Buf

version: v1
deps:
- buf.build/googleapis/googleapis
lint:
use:
  - DEFAULT
breaking:
use:
  - FILE

deps:
- buf.build/googleapis/googleapis

buf build \
--type acme.weather.v1.Units \
--type acme.weather.v1.CurrentWeather.Temperature

docker run \
--volume "$(pwd):/workspace" \
--workdir /workspace \
bufbuild/buf build

# 配置protoc生成规则
version: v1
managed:
enabled: true
go_package_prefix:
# proto文件中不使用option定义包名称，因为proto生成代码可以放在不同项目中使用，因此在buf.gen.yaml中进行定义
default: go/apigen
except:
  - buf.build/googleapis/googleapis
plugins:
# 使用go插件生成go代码
- name: go
out: apigen/go
opt: paths=source_relative
# 使用go-grpc插件生成grpc代码
- name: go-grpc
out: apigen/go
opt:
  - paths=source_relative
  - require_unimplemented_servers=false 
# 使用grpc-gateway插件生成grpc-gateway代码
- name: grpc-gateway
out: apigen/go
opt: paths=source_relative
# 使用openapiv2插件生成swagger文件
- name: openapiv2
out: apigen
opt:
  - allow_repeated_fields_in_body=true

buf generate --template buf.gen.go.yaml
buf generate --template buf.gen.java.yaml

buf generate --path proto/foo --path proto/bar

buf generate https://github.com/foo/bar.git --template data/generate.yaml -o bar

version: v1
lint:
 use:
   - DEFAULT
 except:
   - PACKAGE_VERSION_SUFFIX
   - FIELD_LOWER_SNAKE_CASE
   - SERVICE_SUFFIX
 ignore:
   - google/type/datetime.proto  
breaking:
 use:
   - FILE

.
├── buf.work.yaml
├── proto
│   ├── acme
│   │   └── weather
│   │       └── v1
│   │           └── weather.proto
│   └── buf.yaml
└── vendor
    └── protoc-gen-validate
        ├── buf.yaml
        └── validate
            └── validate.proto

version: v1
directories:
  - proto
  - vendor/protoc-gen-validate