在 google cloud datastore 中，通过开发者控制台手动输入无小数位的数字（如 `10` 或 `1.00`）时，系统会自动推断为整型（`int`），导致 go 应用读取时无法正确反序列化到 `float64` 字段；而使用 go sdk 的 `put` 方法写入则可严格保持类型。
这是一个典型的类型推断陷阱，根源在于 Google Cloud Datastore 的开发者控制台（Dev Console）缺乏显式类型声明能力。当你在控制台中为 Balance 字段输入 10 并勾选 “is a number”，Datastore 会根据字面量形式将其存为 Integer 类型（而非 Double），即使你的 Go 结构体定义为 float64。Go 客户端 SDK 在反序列化时严格遵循存储的实际类型：遇到 Integer 值，它不会自动转换为 float64，而是默认初始化为零值（即 0.0），因此你看到 Balance:0。
✅ 正确做法是避免依赖开发者控制台进行浮点字段的测试录入，改用 Go 代码通过 datastore.Put() 显式写入：
type Account struct {
Balance float64 `datastore:"balance"`
UserID int `datastore:"userid"`
}
// 正确：使用 Put 写入，类型由 Go 类型系统保证
account := &Account{
Balance: 10.0, // 即使是 10.0，Go 仍视为 float64
UserID: 1,
}
key := datastore.NameKey("Account", "test123", nil)
_, err := client.Put(ctx, key, account)
if err != nil {
log.Fatal(err)
}此时 Datastore 后端将准确存储为 Double 类型，后续 client.Get() 调用也能无损还原为 float64 —— 包括 .00 等精度信息（注意：float64 本身不保存尾随零格式，但数值精度完整保留）。
⚠️ 注意事项：
- 开发者控制台仅适用于快速原型验证，不可用于需要精确数值类型的场景；
- 若必须在控制台调试，可临时将字段改为 interface{} 或自定义 UnmarshalDatastore 方法做运行时类型适配（不推荐，增加复杂度）；
- 对于金额等敏感字段，建议额外添加校验逻辑（如 Balance >= 0）并在 Get 后检查是否为零值异常；
- 在生产环境中，所有数据写入应统一通过 SDK 进行，确保类型一致性与可测试性。
总结：Datastore 的类型安全依赖于写入方式而非结构体声明。坚持“代码写入、代码读取”原则，即可彻底规避该问题。
