0

0

如何在 Go 的 struct 标签中正确使用反引号()映射数据库列名

聖光之護

聖光之護

发布时间:2026-03-06 12:24:02

|

290人浏览过

|

来源于php中文网

原创

如何在 go 的 struct 标签中正确使用反引号()映射数据库列名

Go 中 struct 的 db 标签必须使用反引号()包裹,而非单引号(')或双引号(");错误使用引号会导致编译错误或字段映射失败,尤其在列名含大小写、下划线且与 Go 命名规范不一致时。

Go 中 struct 的 db 标签必须使用反引号(`)包裹,而非单引号(')或双引号(");错误使用引号会导致编译错误或字段映射失败,尤其在列名含大小写、下划线且与 Go 命名规范不一致时。

在 Go 生态中(尤其是使用 sqlx、gorm 等 ORM/SQL 工具时),struct 字段与数据库列的映射依赖于结构体标签(struct tags)。一个常见却极易出错的问题是:误用单引号 ' 或双引号 " 来定义 db 标签——这不仅违反 Go 语言规范,还会导致编译失败(如 illegal rune literal)或运行时字段未匹配(如 missing destination 错误)。

根本原因在于:Go 要求所有 struct 标签必须用反引号(`)包围,这是唯一合法的语法。反引号允许标签内自由使用双引号、单引号、空格及特殊字符,而不会触发字符串解析或转义问题。例如:

✅ 正确写法(使用反引号):

type pah struct {
    FMRFundNumber                  string  `db:"FMR_Fund_Number"`
    BusinessDataDate               string  `db:"Business_Data_Date"`
    OutboundCompositionCode        string  `db:"Outbound_Composition_Code"`
    CompositionSubCode             string  `db:"Composition_Sub_Code"`
    CompositionSubCodeDescription  string  `db:"Composition_Sub_Code_Description"`
    PositionName                   string  `db:"Position_Name"`
    PrimaryValue                   float64 `db:"Primary_Value"`
    RecordOrder                    int     `db:"Record_Order"`
    TierIndicator                  string  `db:"Tier_Indicator"`
}

❌ 错误写法(导致编译失败):

动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版
动态WEB网站中的PHP和MySQL:直观的QuickPro指南第2版

动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包

下载
// 编译错误:illegal rune literal(单引号仅用于单字符)
FMR_Fund_Number string 'db:"FMR_Fund_Number"' 

// 编译通过但无效:Go 将其视为普通字符串字面量,非 struct tag
FMR_Fund_Number string "db:'FMR_Fund_Number'"

⚠️ 注意事项:

  • 反引号位于标准美式键盘 Esc 键正下方(非单引号键),切勿混淆;
  • 字段名建议遵循 Go 习惯:使用 UpperCamelCase(导出字段)并去除下划线(如 FMR_Fund_Number → FMRFundNumber),既提升可读性,也避免与 JSON/db 标签耦合过紧;
  • 若数据库列名含空格、连字符或保留字(如 "user-id"、"order"),仍需在 db 标签中完整、准确地写出(用双引号包裹于反引号内),sqlx 会自动处理转义;
  • 确保字段为导出字段(首字母大写),否则反射无法访问,sqlx.Select() 将静默忽略该字段;
  • 使用 sqlx.DB.Select() 时,若仍报 missing destination,请检查:① 字段是否导出;② 标签是否为反引号;③ 查询结果列名是否与 db 标签值完全一致(区分大小写,取决于数据库配置)。

最后,验证映射是否生效的简单方式是打印 sqlx 生成的字段映射:

mapper := sqlx.NameMapper
fmt.Printf("Mapped field: %s → %s\n", "FMRFundNumber", mapper("FMRFundNumber")) // 输出: fmrfundnumber(若用 ToLower)

但请注意:sqlx 的默认 NameMapper 仅影响无显式 db 标签时的自动推导;一旦设置了 db:"...",则完全以标签值为准,与命名映射器无关——这正是解决混合命名风格数据库的关键所在。

掌握反引号的正确用法,是构建健壮、可维护 Go 数据层的基础一步。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

210

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

246

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

355

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

214

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

407

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

450

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

200

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

1356

2025.06.17

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

1

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 5.9万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号