Kotlinのコンパニオンオブジェクトとは？初心者向けに使い方と役割をわかりやすく解説！

Kotlinのコンパニオンオブジェクトの基本と使い道を解説

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

生徒

「Kotlinで『コンパニオンオブジェクト』っていう言葉を聞いたんですが、何に使うんですか？」

先生

「コンパニオンオブジェクトは、クラスの中で使える特別なオブジェクトで、Javaでいうところの『static（スタティック）』な機能に近いものです。」

生徒

「staticってなんですか？そしてKotlinではどう書くんですか？」

先生

「staticは、クラスのインスタンスを作らなくても直接使える機能です。Kotlinではcompanion objectという形で書くんですよ。では、具体的に説明していきますね。」

1. コンパニオンオブジェクトとは？Kotlinでの意味と役割

コンパニオンオブジェクト（companion object）とは、Kotlinのクラスの中に1つだけ置ける特別なオブジェクトです。「クラスに関係しているのに、毎回インスタンスを作らずに使いたい機能」をまとめる場所、と考えると分かりやすいです。

たとえば、ユーザーの設定やアプリ全体で使う共通データなど、どこからでも呼び出したい処理を入れておくことができます。普通にクラスを作ると、その都度インスタンス化が必要ですが、コンパニオンオブジェクトの中に書いた関数や変数は、クラス名から直接呼び出せます。


class Message {
    companion object {
        val defaultText = "こんにちは！"
    }
}

この例では、Message.defaultTextと書くだけでアクセスできます。Javaではstaticで同じようなことをしますが、Kotlinではstaticを使わず、このcompanion objectで表現します。プログラミング初心者でも直感的に使える便利な仕組みです。

2. Kotlinの基本構文：companion objectの書き方

ここでは、Kotlinのコンパニオンオブジェクト（companion object）を最小構成で定義する基本の書き方を確認します。ポイントは「クラスの中にcompanion object { ... }を1つ用意し、そこにクラス名から直接呼び出したい処理や値を置く」ことです。Javaのstaticの代替として使えるため、インスタンス化せずにアクセスできます。


class User {
    // クラスに1つだけ置ける特別なオブジェクト
    companion object {
        // クラス名から直接参照したい「規定値」
        val DEFAULT_NAME = "ゲスト"

        // 便利な生成処理（いわゆるファクトリーメソッド）
        fun createGuest(): User {
            return User()
        }

        // ちょっとした共通処理もまとめられる
        fun displayWelcome(name: String = DEFAULT_NAME): String {
            return "ようこそ、$name さん"
        }
    }
}

上の例では、User.DEFAULT_NAMEのようにクラス名.メンバーで値や関数を使えます。インスタンスを作らずに共通の初期値や作成用関数（ファクトリーメソッド）にアクセスできるため、Kotlinのコンパニオンオブジェクトの使い方・基本構文として覚えておくと便利です。


// 使い方のイメージ（呼び出しはクラス名から）
val guest = User.createGuest()
val text = User.displayWelcome(User.DEFAULT_NAME)

このように、「クラスに関係するけれどインスタンス不要」な機能を集約できるのがコンパニオンオブジェクトの魅力です。Kotlinの書き方としてまずはこの形を押さえておけば、後続の実用例にも自然につながります。

3. コンパニオンオブジェクトの使い方：コード例

先ほどのUserクラスを使って、実際に呼び出してみましょう。


fun main() {
    println(User.DEFAULT_NAME)
    val guest = User.createGuest()
    println(guest)
}

このコードの出力結果は次のようになります。


ゲスト
User@xxxxxxxx

このように、Userクラスをわざわざインスタンス化しなくても、DEFAULT_NAMEやcreateGuest()に直接アクセスできます。

4. コンパニオンオブジェクトを使う場面とは？

Kotlinのコンパニオンオブジェクトは、次のような場面でよく使われます。

クラスから直接アクセスできる定数の定義（例：APIキーやバージョン）
インスタンスを作るための関数（ファクトリーメソッド）
共通処理をまとめたいとき（クラス全体に関係するもの）

初心者の方は、「このクラスに関係するけど、毎回オブジェクトを作らずに使いたいもの」をcompanion objectにまとめる、と考えると理解しやすいです。

5. constとcompanion objectの違いを知ろう

constは「変わらない定数」を定義するためのキーワードで、基本的にコンパニオンオブジェクトの中で使います。


class Settings {
    companion object {
        const val MAX_RETRY = 3
    }
}

このようにしておくと、どこからでもSettings.MAX_RETRYと書くだけで、定数にアクセスできます。

6. 名前付きコンパニオンオブジェクトって？

実は、コンパニオンオブジェクトには「名前」をつけることもできます。


class App {
    companion object Factory {
        fun newInstance(): App {
            return App()
        }
    }
}

ただし、通常は名前をつけずにそのまま使うのが一般的です。Kotlinの文法として名前をつけられるだけで、特別な意味はありません。

7. objectとの違いは？初心者向けにやさしく解説

Kotlinではobjectというキーワードもありますが、objectはクラス外で使うのが基本です。一方、companion objectはクラスの中で使います。


// 通常のobject
object Logger {
    fun log(msg: String) {
        println("ログ: $msg")
    }
}


// クラス内のcompanion object
class Logger {
    companion object {
        fun log(msg: String) {
            println("ログ: $msg")
        }
    }
}

どちらも「1つだけのオブジェクト」ですが、使い方の場所や目的が違うということを覚えておきましょう。

まとめ

Kotlinにおけるコンパニオンオブジェクトは、Javaのstaticに相当する機能を提供する重要な構文です。本記事では、初心者の方にもわかりやすく、「クラスのインスタンスを生成しなくても使える関数や定数を定義できる仕組み」であることを中心に解説しました。

実際の例として、DEFAULT_NAMEやcreateGuest()のように、直接クラス名から呼び出せるコードを提示しました。これにより、共通の定数や便利な生成関数をコンパクトに定義でき、コードの再利用性と読みやすさが向上します。

また、constとの違いや、objectとの使い分けも重要です。特にobjectはクラス外で使うケースが多く、companion objectはクラスの内部で活用される点を押さえておくと混乱しにくくなります。

コンパニオンオブジェクトは、Kotlinの設計思想に沿ったモダンなプログラミングスタイルを可能にし、特にAndroidアプリ開発やサーバーサイド開発においても多用されるテクニックです。名前付きで定義することで、読み手にとっての明確な意図を伝えることもできます。

以下は、この記事の学びを活かした応用例です。定数の定義やインスタンス生成関数を活用して、API設定などに対応したコードです。


class Config {
    companion object {
        const val BASE_URL = "https://api.example.com"
        fun buildEndpoint(path: String): String {
            return "$BASE_URL/$path"
        }
    }
}

fun main() {
    println(Config.BASE_URL)
    println(Config.buildEndpoint("user/profile"))
}

このように、Kotlinのコンパニオンオブジェクトを活用することで、コードの構造をシンプルに保ちつつ、再利用性・保守性・可読性を高めることができます。初心者の方も、まずは定数や簡単な関数から導入していきましょう。

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

生徒

「コンパニオンオブジェクトって、結局どういう場面で使うのがいいんでしょうか？」

先生

「例えば、APIのエンドポイントや定数をまとめておきたいとき、またはインスタンスを毎回作らずに使いたい関数を定義したいときに便利ですね。」

生徒

「なるほど！それにクラス名から直接アクセスできるのが便利ですね。」

先生

「そのとおりです。Kotlinではstaticというキーワードは使いませんが、コンパニオンオブジェクトを使えば似たような機能を安全に提供できますよ。」

生徒

「あと、objectとの違いもなんとなくわかってきました。外で使うのがobject、クラスの中で使うのがcompanion objectですね。」

先生

「その理解でバッチリです。慣れてきたら、名前付きのcompanion objectや、コードの整理にも活用してみましょう。」

生徒

「はい！今日の学びを活かして、これからどんどんKotlinを使いこなしたいです！」

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

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

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

Kotlinのコンパニオンオブジェクトとは何ですか？ staticとの違いは何ですか？

Kotlinのコンパニオンオブジェクトは、クラスの中で定義され、インスタンス化せずに使える機能です。Javaで使われるstaticのように、共通の関数や定数を定義する際に使いますが、Kotlinではstaticキーワードを使わず、代わりにcompanion objectで実現します。

Kotlinのcompanion objectで定義された定数や関数は、どのようにアクセスすればよいですか？

クラス名を使って、直接アクセスできます。たとえば、Userクラスにcompanion objectがあれば、User.DEFAULT_NAMEやUser.createGuest()のように使えます。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。