# goctl compatibility 手册

完整矩阵见 [goctl compatibility matrix](../goctl-compatibility.md)。

## 当前定位

rs-zero 的 goctl compatibility 指“输入语义和工作流兼容”，不是 Go 输出逐字一致。

## 已覆盖主路径

- API：`.api` parser、local import、format、OpenAPI、Rust REST skeleton。
- Model：MySQL `CREATE TABLE` 子集、字段/索引 metadata、cache key、Rust repository/cache skeleton。
- RPC：proto3 子集、local/transitive import、well-known import、tonic skeleton。
- CLI：`goctl compat matrix`、API format、model gen、RPC gen。

## Golden tests

fixtures 位于 `tests/fixtures/goctl/`，测试位于：

- `tests/goctl_api_compat.rs`
- `tests/goctl_model_compat.rs`
- `tests/goctl_rpc_compat.rs`
- `tests/goctl_cli_compat.rs`

## 不支持项

Java/Dart/TypeScript/Kotlin 生成器、Mongo、gateway、plugin、upgrade、完整 protobuf 编译链、完整 MySQL grammar、goctl Go 输出逐字一致。
