0

0

Golang使用指针作为函数参数的最佳实践

P粉602998670

P粉602998670

发布时间:2026-01-10 09:37:02

|

241人浏览过

|

来源于php中文网

原创

该传 *T 而不是 T 的核心判断标准是:是否需要修改调用方原始值且类型体积大或语义要求可变;否则优先传 T,避免不必要的 nil 检查与风险。

golang使用指针作为函数参数的最佳实践

什么时候该传 *T 而不是 T

核心判断标准:是否需要函数内部修改调用方的原始值,且该类型体积较大(如结构体)或语义上明确要求“可变”。
Go 中所有参数都是值传递,T 会复制整个值;*T 复制的是指针(8 字节),开销固定。但指针带来可变性风险——哪怕只是读取,也可能因并发或误写导致意外修改。
常见误用场景:为一个只读的 stringint*,既无必要又增加 nil 检查负担。

  • 必须用 *T:函数需修改结构体字段(如 user.SetName("x"))、初始化未导出字段、或避免大结构体拷贝(>128 字节建议测一下)
  • 优先用 T:基础类型(intstringbool)、小结构体(如 type Point struct{ X, Y int })、纯计算函数(如 Normalize(v Vector) Vector
  • 接口值本身已是指针语义:接收 io.Reader 不需要写 *io.Reader,因为接口底层包含指针

nil 检查不是可选动作,而是接口契约的一部分

一旦函数签名接受 *T,调用方就可能传 nil。不检查直接解引用会 panic:panic: runtime error: invalid memory address or nil pointer dereference。这不是防御性编程的“礼貌”,而是明确定义函数行为边界的必需步骤。

  • 在函数入口立即检查:
    func ProcessUser(u *User) error {
        if u == nil {
            return errors.New("user cannot be nil")
        }
        // 后续安全使用 u.Name, u.ID 等
    }
  • 不要把 nil 检查推迟到深层逻辑(如某个字段赋值前),那会让错误位置难以定位
  • 若业务逻辑允许 nil(如可选配置),应显式命名参数并文档化,例如 opts *ProcessOptions 并注明 “nil means defaults”

方法接收者用 *T 还是 T?看是否要改状态

这和函数参数逻辑一致,但更易混淆——因为 Go 允许对 T 类型值调用 *T 接收者方法(编译器自动取地址),反之则不行。这种隐式转换掩盖了真实意图。

  • *T 接收者:方法会修改接收者字段(如 func (u *User) SetEmail(e string) { u.Email = e }
  • T 接收者:方法只读,且不希望调用方意外传入指针(比如防止并发写同一对象);也适用于不可寻址值(如字面量 User{}.Name()
  • 混用危险:同一个结构体上既有 T 又有 *T 方法,会导致方法集分裂——var u User 只能调用 T 方法;var u *User 能调用全部。这会让使用者困惑,也不利于接口实现一致性

切片、map、channel 本身已是引用类型,别画蛇添足加 *

这是新手高频踩坑点:[]intmap[string]intchan int 在底层都是包含指针的结构体(如 slicestruct{ ptr *int, len, cap int })。传它们本身就能修改底层数组或哈希表,加 * 只会让代码更难读、更易出错。

AMiner
AMiner

AMiner——新一代智能型科技情报挖掘与服务系统,能够为你提供查找论文、理解论文、分析论文、写作论文四位一体一站式服务。

下载

立即学习go语言免费学习笔记(深入)”;

  • 错误写法:func AppendItem(items *[]int, x int) —— 需要双重解引用 *items = append(*items, x),且调用时得写 &mySlice
  • 正确写法:func AppendItem(items []int, x int) []int —— 返回新切片,由调用方决定是否赋值:mySlice = AppendItem(mySlice, 42)
  • map 和 channel 同理:传 map[string]int 就能直接 m["k"] = v,无需 *map

真正需要指针的,是想替换整个 map 变量本身(比如清空并重新分配底层数组),但这极少见,通常说明设计有问题。

相关专题

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

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

177

2024.02.23

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

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

226

2024.02.23

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

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

336

2024.02.23

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

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

208

2024.03.05

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

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

388

2024.05.21

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

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

194

2025.06.09

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

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

189

2025.06.10

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

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

191

2025.06.17

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

25

2026.01.09

热门下载

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

精品课程

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

共32课时 | 3.6万人学习

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

共10课时 | 0.8万人学习

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

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