カテゴリ: Go言語 更新日: 2026/10/12

Go言語の文字列フォーマット!fmt.Sprintfで簡単に出力を整形する方法

Go言語の文字列フォーマット!fmt.Sprintfを使った出力例
Go言語の文字列フォーマット!fmt.Sprintfを使った出力例

先生と生徒の会話形式で理解しよう

生徒

「Go言語で文字列と数値を組み合わせて出力したいときはどうすればいいですか?」

先生

「その場合はfmt.Sprintfを使うと便利です。文字列の中に数値や他の変数を埋め込むことができます。」

生徒

「具体的にはどのように書くのですか?」

先生

「文字列の中に%dや%sなどの書式指定子を使って変数を埋め込みます。それでは基本的な使い方を見てみましょう!」

1. fmt.Sprintfとは?

1. fmt.Sprintfとは?
1. fmt.Sprintfとは?

Go言語のfmt.Sprintfは、文字列をフォーマットして新しい文字列を作るための関数です。普段のprint関数と違い、その場で表示するのではなく「文字列として結果を返す」のが特徴です。Sprintfの「S」はStringの頭文字で、生成した文章をそのまま変数に入れて後で使うことができます。

たとえば、画面に出す前にメッセージを組み立てたいときや、ログとして保存したいときに役立ちます。「名前」や「数値」を文章の中に自然に埋め込めるので、初心者の人でも読みやすいメッセージを簡単に作れます。


package main

import (
    "fmt"
)

func main() {
    user := "太郎"
    msg := fmt.Sprintf("%sさん、ようこそ!", user)
    fmt.Println(msg)
}

太郎さん、ようこそ!

このように、作成した文字列は変数msgに入っているので、後から記録したり別の処理に渡したりできます。単に画面に表示するだけでなく、自由な場面で活用できるのがfmt.Sprintfの便利なポイントです。

2. 基本的な使い方

2. 基本的な使い方
2. 基本的な使い方

まずは、変数を文章の中に埋め込む簡単な例を見てみましょう。たとえば、名前と年齢をひとつの文章として表示したいとき、文字列をそのまま結合しようとすると「+」を使ったり、スペースを自分で入れたりと少し面倒です。そこでfmt.Sprintfを使うと、自然な文章の形で文字列を作ることができます。


package main

import (
    "fmt"
)

func main() {
    name := "太郎"
    age := 25
    result := fmt.Sprintf("私の名前は%sで、年齢は%d歳です。", name, age)
    fmt.Println(result)
}

私の名前は太郎で、年齢は25歳です。

ここで使っている%sは「文字列を入れる場所」、%dは「整数を入れる場所」を表しています。このように書式指定子と変数を並べてあげるだけで、きれいな文章が作れます。文字列をつなげるより読みやすく、プログラムを見た人にも意図が伝わりやすくなるので、初心者の方にもおすすめです。

生徒

「確かに “+” でつなげるよりずっと読みやすいですね。でも、どうしてわざわざ書式指定子を使うんですか?」

先生

「いい質問ですね。例えば、年齢のあとに “歳” と書き忘れたり、順番を間違えたりすることがなくなるんです。文章の形を先に作っておいて、あとから変数を埋め込むだけなので、コードもスッキリします。」

生徒

「なるほど。文章として先に書けるから、どんな内容になるか想像しやすいんですね!」

3. 小数点や浮動小数点数のフォーマット

3. 小数点や浮動小数点数のフォーマット
3. 小数点や浮動小数点数のフォーマット

fmt.Sprintfで小数点を含む数値を文字列に整形するときは%fを書式指定子として使います。何もしないと小数点以下は6桁で表示されますが、%.2fのように「.の後に桁数」を付ければ表示する小数桁を自由にコントロールできます。表示時は四捨五入されるため、価格や平均値などを見やすく出したいときにとても便利です。まずは基本の書き方と、よくあるパターンをまとめて確認してみましょう。


package main

import (
    "fmt"
)

func main() {
    price := 1234.567

    basic := fmt.Sprintf("%f", price)        // 既定は小数点以下6桁
    two := fmt.Sprintf("%.2f", price)        // 小数点以下2桁(四捨五入)
    zero := fmt.Sprintf("%.0f", price)       // 小数点以下0桁=整数表示
    width := fmt.Sprintf("%8.2f", price)     // 幅8・小数2桁(桁揃えに便利)
    percent := fmt.Sprintf("%.1f%%", price)  // 割合表示の例(末尾の%は%%と書く)

    fmt.Println(basic)
    fmt.Println(two)
    fmt.Println(zero)
    fmt.Println(width)
    fmt.Println(percent)
}

1234.567000
1234.57
1235
 1234.57
1234.6%

上の例では、小数桁の指定(%.2fや%.0f)と、桁揃えに役立つ幅指定(%8.2f)を使っています。幅指定は、一覧表示やレポート出力で小数点を揃えたいときに重宝します。また、パーセント記号をそのまま出したいときは%%と二重に書く点も覚えておくと安心です。まずは「桁数は%.nfで決める」「%を書きたいときは%%」という2点を押さえるだけで、実務で使えるきれいな数値フォーマットが作れます。

生徒

「小数点以下をきっちり二桁にしたいのですが、計算結果が長くても大丈夫ですか?」

先生

「大丈夫です。%.2fのように書けば、自動で四捨五入して二桁に整えてくれます。通貨や平均点など、読みやすさを優先したい表示に向いていますよ。」

4. 複数の変数を組み合わせる

4. 複数の変数を組み合わせる
4. 複数の変数を組み合わせる

複数の値(文字列・整数・小数)をひとつの文章にまとめたいときはfmt.Sprintfが最短ルートです。文章の中に並べた書式指定子(%s・%d・%.1fなど)の順番と、後ろに渡す変数の順番を対応させるだけで、自然な日本語のメッセージやログ行が作れます。単位(「歳」「cm」)や区切り(読点・スペース)も文字列として一緒に書いておくと、読みやすさがぐっと上がります。


package main

import (
    "fmt"
)

func main() {
    name := "花子"
    age := 30
    height := 165.5

    // 基本:文字列・整数・小数を順番に埋め込む
    result := fmt.Sprintf("%sさんは%d歳で身長は%.1fcmです。", name, age, height)
    fmt.Println(result)

    // 応用:ラベル付きで読みやすく
    labeled := fmt.Sprintf("名前: %s / 年齢: %d / 身長: %.1fcm", name, age, height)
    fmt.Println(labeled)
}

花子さんは30歳で身長は165.5cmです。
名前: 花子 / 年齢: 30 / 身長: 165.5cm

ポイントは「書式指定子の位置=値が入る位置」。文章の型を先に作り、あとから値を渡す発想にすると、表記ゆれや記号の付け忘れを避けられます。迷ったら万能型の%vでも整形できますが、桁数や体裁を決めたい場面では型に合った指定子(文字列は%s、整数は%d、小数は%.nf)を使うのがおすすめです。

生徒

「値の順番を間違えそうで不安です。確認するコツはありますか?」

先生

「文章を声に出して読み、%sには“名前”、%dには“年齢”というように対応を指差し確認しましょう。必要なら一時変数に入れてから渡すとミスが減りますよ。」

5. fmt.Sprintfを使うときの注意点

5. fmt.Sprintfを使うときの注意点
5. fmt.Sprintfを使うときの注意点

fmt.Sprintfはとても便利ですが、いくつか気を付けたいポイントがあります。特に多いのが「書式指定子と値の型が合っていない」ケースです。例えば整数用の%dに文字列を入れてしまうと、実行時にエラーが出て正しく動きません。プログラムが止まってしまう原因になるので、型と指定子の対応関係は必ず確認しましょう。


package main

import (
    "fmt"
)

func main() {
    age := "20"
    // 間違い:%dは整数専用、文字列を入れるとエラー
    wrong := fmt.Sprintf("年齢は%d歳です。", age)
    fmt.Println(wrong)
}

この例は文字列型のageに%dを使っているため、「型が違う」と怒られてしまいます。正しく書くなら、整数に変換してから%dを使うか、文字列として%sを使う方法があります。


package main

import (
    "fmt"
)

func main() {
    age := "20"
    result := fmt.Sprintf("年齢は%s歳です。", age) // 文字列なので%s
    fmt.Println(result)
}

年齢は20歳です。

もう1つ気を付けたいのは、Sprintfは「文字列を返すだけ」で、画面には表示しないことです。値を確認したいときは、必ずfmt.Printlnやfmt.Printと組み合わせます。返された文字列を変数に入れておけば、あとでログに残したりファイルに書き込んだり、別の処理へ渡すこともできます。


package main

import (
    "fmt"
)

func main() {
    name := "太郎"
    message := fmt.Sprintf("%sさんがログインしました。", name)

    // 画面に出したい場合はPrint系の関数を使う
    fmt.Println(message)
}

太郎さんがログインしました。

このように、Sprintfは「整形して文字列を作る」「表示は別で行う」という役割がはっきり分かれています。型のミスを防ぎつつ、作成した文字列を必要な場所で使えるのが最大の強みです。

生徒

「変数の型を間違えると動かなくなるのは怖いですね……」

先生

「最初はゆっくり確認して大丈夫ですよ。慣れてくると、%sは文字、%dは整数、%fは小数、と自然に選べるようになります。焦らず、少しずつ身につけていきましょう。」

6. 文字列フォーマットの活用例

6. 文字列フォーマットの活用例
6. 文字列フォーマットの活用例

たとえば、日付や通貨、割合などを整形して表示したい場合にfmt.Sprintfは非常に便利です。固定幅で揃えたいときや、小数点以下を調整したいときに活用できます。これにより、見やすく読みやすい出力が簡単に作れます。

まとめ

まとめ
まとめ

Go言語でプログラムを書いていると、人間が読みやすいメッセージを出したい場面がたくさんあります。数字だけ並べても伝わりにくかったり、ログに残したい文章が長くて書きにくかったり、途中で修正したくなって書き直しが大変だったりします。そんなときに力を発揮してくれるのがfmt.Sprintfです。文字列を繋げるのではなく、文章の形を先に作り、そこへ値を埋め込む書き方は、読みやすさと管理しやすさの両方を助けてくれます。

書式指定子を使うことで、名前や年齢のようなシンプルなデータはもちろん、金額や身長、商品価格、割合、日付といったさまざまな種類の値を綺麗に整形できます。単位を付けたり桁数を揃えたり、ゼロで埋めたりすることで、画面に表示する文章がぐっと洗練され、ユーザーにとって読みやすい表示へと変わります。小さな工夫ですが、丁寧に整った出力はアプリケーション全体の印象にも影響します。

また、fmt.Sprintfは文字列として作成した結果をそのまま変数に入れられるため、後からファイルに書き込んだり、ログに残したりする処理へ渡せる点も便利です。見た目を整えるだけでなく、プログラムの構造そのものがすっきりします。画面への出力とは別の場所に文字列を使い回すことができるので、再利用性の高いコードを目指すときにも役立ちます。

まとめとしてのサンプルプログラム

最後に、さまざまな書式指定子を組み合わせて、見やすい文章を作る例をもうひとつ見ておきましょう。「日付」「価格」「割引率」「商品名」をひとつの文章として整形し、後からログへ保存するイメージのサンプルです。


package main

import (
    "fmt"
)

func main() {
    product := "りんご"
    price := 180.0
    discount := 0.15
    year := 2025
    month := 7
    day := 3

    msg := fmt.Sprintf("%sの価格は%.2f円、割引率は%.1f%%です。販売日は%04d-%02d-%02dです。",
        product, price, discount*100, year, month, day)

    fmt.Println(msg)
}

りんごの価格は180.00円、割引率は15.0%です。販売日は2025-07-03です。

ひとつひとつの値を並べて出すだけでも動きますが、整えた形で表示するだけで、読み手の印象は大きく変わります。特に仕事で使うログや、利用者へ見せる画面は、数値をきちんと整形するかどうかで「丁寧に作られているか」が伝わります。こうした細かい作業は後回しにされることもありますが、一度書式を覚えると色々な画面や処理に応用できるため、覚えて損はありません。

今回学んだように、%sは文字列、%dは整数、%fは小数、そして小数点以下の桁数を指定したい場合は%.2fや%.1fのように書けます。日付には%04dや%02dなどのゼロ埋めを使えば、桁が揃って見た目も綺麗になります。この考え方を意識するだけで、まるで整った帳票やレポートのような出力を作ることができます。

書式指定子と変数の型が一致しているかどうか、出力したい桁数は正しいか、順番はあっているか。この三つを意識するだけで、失敗しないフォーマット操作ができます。エラーが出たときは、どの書式指定子を使ったのかを一度見直してみましょう。最初は少し難しく感じる部分ですが、慣れてくると無意識で使えるようになります。

そして何より、fmt.Sprintfは「使っただけ結果が目に見える」機能なので、試しながら覚えるのに向いています。変数の値を変えたり、桁数を変えたり、文章の形を変えたりと、いろいろ実験してみてください。自分なりに読みやすい形を作っていくことで、理解が自然と深まります。

先生と生徒の振り返り会話

生徒

「文字列をつなげるより、fmt.Sprintfで整形したほうがきれいになる理由が分かりました。小数の桁も揃えられるし、日付もゼロ埋めで綺麗に表示できますね。」

先生

「そのとおりです。読みやすい出力は、それだけでプログラムの質を高めます。%s%d%fの基本さえおさえれば、あとは応用するだけです。」

生徒

「ログや表示にも使えそうです。これからの課題でも試してみます!」

先生

「自分で触ってみるのが一番身につきます。ぜひ色々なパターンを作ってみてください。」

Go言語を基礎からスッキリ学びたい人や、 文法だけでなく「実用的な使い方」まで押さえたい人には、 定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

この記事を読んだ人からの質問

この記事を読んだ人からの質問
この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問/質問を解決します

Go言語のfmt.Sprintfはどんな場面で使うのですか?

Go言語のfmt.Sprintfは、文字列を整形してわかりやすく加工したいときに使われます。たとえば、名前と年齢を文章として表示したいとき、数値と文字列を混ぜたいとき、ログにわかりやすいメッセージを出力したいときなど、さまざまな場面で活躍します。画面に出力する前に、整った文章を作りたい人にとって便利な関数です。

fmt.Sprintfを使うとどんなメリットがありますか?

fmt.Sprintfを使うことで、文字列の中に変数を安全に埋め込むことができます。文字列を連結するよりも読みやすく、修正しやすい形になるため、プログラミング初心者でも扱いやすいです。複雑な文章もまとめて加工できるため、Go言語で文章を作るときにはとても役立ちます。

書式指定子とは何ですか?

書式指定子とは、文字列の中に埋め込む変数の種類を指定するための記号です。たとえば、文字列ならパーセントエス、整数ならパーセントディー、小数ならパーセントエフなどを使います。書式指定子を使うことで、どの変数をどの形式で表示したいかを明確にすることができます。

パーセントエスとパーセントディーの違いは何ですか?

パーセントエスは文字列を埋め込むための書式指定子で、パーセントディーは整数を埋め込むための書式指定子です。名前などのテキストを扱うときはパーセントエス、年齢や得点などの数値を扱うときはパーセントディーを使います。型に合わせて使い分けることで正しい出力ができます。
関連セミナーのご案内

【超入門】ゼロから始めるGo言語プログラミング:最速で「動くアプリ」を作るマンツーマン指導

「プログラミングの仕組み」が根本からわかる。Go言語でバックエンド開発の第一歩を。

本講座を受講することで、単なる文法の暗記ではなく、「プログラムがコンピュータの中でどう動いているか」という本質的な理解につながります。シンプルながら強力なGo言語(Golang)を通じて、現代のバックエンドエンジニアに求められる基礎体力を最短距離で身につけます。

具体的な開発内容と環境

【つくるもの】
ターミナル(黒い画面)上で動作する「対話型計算プログラム」や、データを整理して表示する「ミニ・ツール」をゼロから作成します。自分の書いたコードが形になる感動を体験してください。

【開発環境】
プロの現場でシェアNo.1のVisual Studio Code (VS Code)を使用します。インストールから日本語化、Go言語用の拡張機能設定まで、現場基準の環境を一緒に構築します。

この60分で得られる3つの理解

1. 環境構築の完全な理解

「なぜ動くのか」という設定の仕組みを理解し、今後の独学で詰まらない土台を作ります。

2. Go言語の基本構造(変数・型)

データの種類やメモリの概念など、他言語にも通じるプログラミングの本質を学びます。

3. 読みやすいコードの書き方

ただ動くだけでなく、誰が見ても分かりやすい「綺麗なコード」を書くための考え方を伝授します。

※本講座は、将来的にバックエンドエンジニアやクラウドインフラに興味がある未経験者のためのエントリー講座です。マンツーマン形式により、あなたの理解度に合わせて進行します。

セミナー画像

初めてのGo言語を一緒に学びましょう!

関連記事:
カテゴリの一覧へ
新着記事
New1
Go言語
Go言語の配列の基本!定義・初期化・アクセス方法をやさしく解説
New2
Kotlin
Kotlinのコンパニオンオブジェクトとは?初心者向けに使い方と役割をわかりやすく解説!
New3
Kotlin
Kotlinのラムダ式(無名関数)の基本と書き方を初心者向けに解説
New4
Swift
Swiftのswitch文の使い方|初心者でもわかるパターンマッチング徹底解説
人気記事
No.1
Java&Spring記事人気No1
C#
C#プログラムの基本的な書き方を完全解説!初心者でもわかる文法入門ガイド
No.2
Java&Spring記事人気No2
Swift
Swift入門ガイド|基本構文と書き方をマスターしよう
No.3
Java&Spring記事人気No3
TypeScript
TypeScriptでプロパティを追加・更新・削除する方法を完全解説 初心者でもわかるオブジェクト操作の基本
No.4
Java&Spring記事人気No4
Swift
Swift Playgroundの使い方を完全解説!初心者に最適な学習環境の始め方
No.5
Java&Spring記事人気No5
C#
C#で余りを求める方法!剰余演算子パーセントの使い方を初心者向けに解説
No.6
Java&Spring記事人気No6
Swift
Swift Package Manager(SwiftPM)入門|基本と使い方を初心者向けに徹底解説
No.7
Java&Spring記事人気No7
TypeScript
TypeScriptでユーザー定義型ガードを作成する方法を解説
No.8
Java&Spring記事人気No8
Go言語
Go言語のバイナリサイズを小さくする方法を徹底解説!初心者でも分かるビルド最適化テクニック

💻 作業効率アップに

ノートPCを縦置きしてデスクを広く。
省スペースで片づく定番スタンド

UGREEN 縦型スタンドをAmazonで見る

※ Amazon広告リンク