GoLand需手动配置Thrift插件与工具链：安装匹配版本thrift编译器、启用Thrift Support插件并禁用自动格式化、生成代码路径须严格对齐go.mod module路径、Transport/Protocol两端必须显式一致。
GoLand 本身不内置 Thrift 支持，但能通过插件 + 外部工具链完成 IDL 编辑、代码生成和调试闭环。关键不是“配置 GoLand”，而是让 GoLand 正确识别并协同你本地已配好的 Thrift 工具链。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
Thrift 编译器必须手动安装且版本严格对齐
GoLand 不会帮你装 thrift 命令行工具，它只调用你 PATH 里的可执行文件。
常见错误现象：点击 “Generate Thrift code” 报错 thrift: command not found 或生成后编译失败提示 undefined: xxx。
- 必须从 https://thrift.apache.org/download 下载与 Go 库匹配的二进制（例如 thrift-0.19.0），不能用系统包管理器（如 apt install thrift-compiler）安装——Ubuntu/Debian 源里版本普遍滞后，且常缺 Go 生成器支持
- Go 客户端库必须用同版本源码构建：运行 go get github.com/apache/thrift/lib/go/thrift@v0.19.0（注意 tag）
- 验证一致性：thrift --version 和 go list -m github.com/apache/thrift 输出主版本号必须一致，否则生成代码 import 路径或结构体字段名可能错位
IDL 文件编辑需启用 Thrift 插件并禁用自动格式化
GoLand 默认不识别 .thrift 后缀，需手动启用插件：
- 打开 Settings > Plugins，搜索并启用 Thrift Support（JetBrains 官方插件，非第三方）
- 重启后，.thrift 文件获得语法高亮、字段跳转、IDL 结构预览
- ⚠️ 关键坑：该插件默认开启“Save actions”自动格式化，会把 namespace go xxx 改成 namespace go "xxx"（加引号），导致生成代码 import 路径错误（如变成 import "xxx" 而非 import "github.com/your-org/your-service/gen-go/xxx"）
- 解决：进入 Settings > Editor > General > Save Actions，取消勾选 Thrift 对应的格式化选项
生成代码必须绑定到 go.mod module 路径
GoLand 的 “Generate from Thrift” 功能只是封装了命令行调用，最终仍依赖你写的生成命令是否正确：
- 错误写法：thrift --gen go -o ./gen api.thrift → 生成路径为 ./gen/gen-go/xxx，而 go.mod 中 module 是 github.com/your-org/your-service，则生成代码里 import 写的是 "github.com/your-org/your-service/gen-go/xxx"，但实际目录是 ./gen/gen-go，编译报错
- 正确做法：
- 先确保
go mod init github.com/your-org/your-service已执行 - 生成时用
thrift --gen go -o . api.thrift（输出到当前目录），再手动把gen-go/重命名为gen/ - 或在
go.mod中加replace github.com/your-org/your-service/gen => ./gen，让 import 路径映射到本地
GoLand 中配置 External Tool：
Program: thriftArguments: --gen go -o . $FileName$Working directory: $ProjectFileDir$跨语言调试时 Transport 层必须两端显式对齐
GoLand 可以 attach Go 进程调试，但无法直接 debug Python 服务端；真正卡住的地方往往不在代码逻辑，而在传输层握手：
- 现象：Go 客户端 client.Ping(ctx) 卡死，Python 服务端无日志，netstat 显示连接 ESTABLISHED 但无数据交换
- 根本原因：Python 服务端用 TBufferedTransportFactory，Go 客户端却用了 TFramedTransportFactory（或反之）
- 解决：
- Go 客户端必须显式指定：
transportFactory := thrift.NewTBufferedTransportFactory(1024) - Python 服务端初始化时也必须用
TBufferedTransportFactory，不能依赖默认（某些旧版 thrift-py 默认是 framed） - Protocol 层也要一致：
TBinaryProtocolFactory对TBinaryProtocolFactory，别混用TJSONProtocol
// Transport: TBuffered, Protocol: TBinary，避免后续维护者踩坑
Thrift 的跨语言互通，本质是两端对字节流封装规则的精确共识。GoLand 只是编辑器，它不会替你做协议对齐，也不会修复因版本错配导致的生成代码结构差异——这些必须靠人工验证和显式声明。
