在Golang开发中,fmt包是最常用的标准库之一,主要用于实现内容的输出和格式化操作,几乎所有需要打印调试信息、输出业务数据的场景都会用到它。掌握fmt包的格式化输出方法,能让开发者更高效地调试程序,也能让输出的内容更规整易读。

fmt包常用输出函数
fmt包提供了多个不同功能的输出函数,开发者可以根据是否需要换行、是否格式化来选择对应的函数,常用的输出函数如下:
- Print:输出内容到标准输出,不会自动添加换行符,多个参数之间会用空格分隔。
- Println:输出内容到标准输出,会自动在末尾添加换行符,多个参数之间会用空格分隔。
- Printf:支持格式化占位符,按照指定的格式输出内容,不会自动添加换行符。
- Sprint:和Print功能类似,但是返回格式化后的字符串,不会输出到标准输出。
- Sprintf:和Printf功能类似,但是返回格式化后的字符串,不会输出到标准输出。
基础输出示例
下面是几个基础输出函数的使用示例,展示不同函数的输出差异:
package main
import "fmt"
func main() {
// Print 不会自动换行
fmt.Print("hello")
fmt.Print("world")
// Println 会自动换行
fmt.Println("hello")
fmt.Println("world")
// Printf 支持格式化占位符
name := "张三"
age := 20
fmt.Printf("姓名:%s,年龄:%d", name, age)
}
常用格式化占位符
Printf和Sprintf函数依赖格式化占位符来实现内容的格式化,不同的数据类型对应不同的占位符,常用的占位符分类如下:
通用占位符
| 占位符 | 说明 |
|---|---|
| %v | 按值的默认格式输出 |
| %+v | 输出结构体时会带上字段名 |
| %#v | 输出值的Go语法表示形式 |
| %T | 输出值的数据类型 |
| %% | 输出百分号本身 |
布尔、整数、浮点数占位符
- 布尔类型:%t 输出true或false
- 整数类型:%d 输出十进制整数,%b 输出二进制,%o 输出八进制,%x 输出小写十六进制,%X 输出大写十六进制
- 浮点数:%f 输出十进制浮点数,%e 输出科学计数法形式,%g 根据情况选择%f或%e的形式
字符串和字节占位符
- %s 输出字符串内容
- %q 输出带双引号的字符串
- %x 输出字符串的十六进制形式,每个字节用两个字符表示
- %c 输出对应的Unicode字符
指针占位符
%p 用于输出指针变量的地址,会以十六进制形式展示。
格式化输出示例
下面通过具体的代码示例展示不同占位符的使用效果:
package main
import "fmt"
type User struct {
Name string
Age int
}
func main() {
user := User{Name: "李四", Age: 25}
num := 100
pi := 3.1415926
str := "golang"
// 通用占位符示例
fmt.Printf("默认格式:%vn", user)
fmt.Printf("带字段名:%+vn", user)
fmt.Printf("语法形式:%#vn", user)
fmt.Printf("数据类型:%Tn", num)
// 整数占位符示例
fmt.Printf("十进制:%dn", num)
fmt.Printf("二进制:%bn", num)
fmt.Printf("十六进制:%xn", num)
// 浮点数占位符示例
fmt.Printf("普通浮点数:%fn", pi)
fmt.Printf("科学计数法:%en", pi)
fmt.Printf("自适应格式:%gn", pi)
// 字符串占位符示例
fmt.Printf("普通字符串:%sn", str)
fmt.Printf("带引号字符串:%qn", str)
fmt.Printf("字符串十六进制:%xn", str)
}
输出宽度和精度控制
fmt的格式化占位符还支持设置输出宽度和精度,让输出内容更规整,常见的控制方式如下:
- %5d:指定整数输出宽度为5,不足的部分用空格填充在左边
- %-5d:指定整数输出宽度为5,不足的部分用空格填充在右边
- %.2f:指定浮点数保留2位小数
- %5.2f:指定浮点数总宽度为5,保留2位小数
下面是宽度和精度控制的示例代码:
package main
import "fmt"
func main() {
num1 := 10
num2 := 20
pi := 3.1415
// 宽度控制
fmt.Printf("宽度5右填充:%5dn", num1)
fmt.Printf("宽度5左填充:%-5dn", num2)
// 精度控制
fmt.Printf("保留2位小数:%.2fn", pi)
fmt.Printf("总宽度6保留2位小数:%6.2fn", pi)
}
注意事项
在使用fmt进行格式化输出时,需要注意以下几点:
- 格式化占位符和传入的参数类型要匹配,否则会出现输出错误或者编译报错
- 如果需要输出
<input>这类HTML标签内容,占位符要正确转义,避免被解析为标签 - Sprint和Sprintf系列函数返回的是字符串,不会直接输出到控制台,需要配合其他输出函数使用
fmt包的格式化输出功能非常灵活,除了上述介绍的内容之外,还支持自定义类型的格式化输出,开发者可以通过实现String()方法来定义自定义结构体的默认输出格式。