Copy & Paste Engineer

【Kotlin】DevContainer環境セットアップ

【Kotlin】DevContainer環境セットアップ

Kotlinを学ぶ際、ローカル環境を汚さずにサクッと試せるのがVS CodeのDev Containerです。本記事では、Microsoft公式のJavaベースDev ContainerイメージにKotlinコンパイラを組み込み、.kt（コンパイル実行）と.kts（スクリプト実行）の両方をVS Code上の▶️ボタンで動かす手順を、設定ファイルの解説とともにご紹介します。

Kotlinとは

Kotlin公式サイトによると、KotlinはJetBrains社が開発したJVM上で動作する静的型付け言語です。

Dev Container設定ファイル

以下をプロジェクト直下の.devcontainer/devcontainer.jsonとして保存してください。

// .devcontainer/devcontainer.json
{
  // コンテナ名（任意の識別用）
  "name": "Kotlin Dev Container",

  // ベースとなるイメージ。Java 17（Bullseye）を利用
  "image": "mcr.microsoft.com/devcontainers/java:0-17-bullseye",

  // Dev Container の Features
  "features": {
    // Java Feature：Maven は不要、Gradle のみインストール
    "ghcr.io/devcontainers/features/java:1": {
      "version": "none",
      "installMaven": false,
      "installGradle": true
    },
    // Kotlin コンパイラをコンテナ内に導入
    "ghcr.io/mikaello/devcontainer-features/kotlinc:1": {}
  },

  // VS Code 上のカスタマイズ
  "customizations": {
    "vscode": {
      // インストールする拡張機能一覧
      "extensions": [
        "mathiasfrohlich.Kotlin",         // シンタックスハイライト＆基本補完
        "restia.vscode-kotlin-formatter", // ktlint/ktfmt ベースのフォーマッタ
        "vscjava.vscode-java-pack",       // Java 開発パック（デバッガー等）
        "vscjava.vscode-gradle"           // Gradle タスクランナー
      ],

      // VS Code の設定
      "settings": {
        // .kt/.kts を両方とも Kotlin 言語として認識
        "files.associations": {
          "*.kt": "kotlin",
          "*.kts": "kotlin"
        },

        // Kotlin ファイル全般（.kt/.kts）で保存時に自動フォーマット
        "[kotlin]": {
          "editor.defaultFormatter": "restia.vscode-kotlin-formatter",
          "editor.formatOnSave": true
        }
      }
    }
  },

  // コンテナ起動後に ktlint CLI をダウンロード＆配置
  // restia.vscode-kotlin-formatter が内部で利用する
  "postCreateCommand": "curl -sSLO https://github.com/pinterest/ktlint/releases/download/1.6.0/ktlint && chmod +x ktlint && sudo install -m 0755 ktlint /usr/local/bin/ktlint",

  // ローカルフォルダをコンテナ内 /workspace にマウント
  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
  "workspaceFolder": "/workspace",

  // エディタ終了時にコンテナは停止（デフォルト）
  "shutdownAction": "none"
}

これで .kt,.kts のファイルはエディター上の上部にある▶️ボタンを押すことで実行できます。

使い分けポイント

Kotlinファイルには大きく分けて「コンパイルしてJARを実行する .kt」と「スクリプト実行できる .kts」の2種類があります。用途に応じて使い分けましょう。

用途 ファイル拡張子 特長
大規模アプリ開発 .kt パッケージ管理・IDEフルサポート／デバッグ機能あり
簡易スクリプト実行 .kts 書いてすぐ実行可能／起動オーバーヘッドが小さい

.kt の使い方と実行例

Hello.kt

fun main() {
    println("Hello, world!")
}

実行コマンド

kotlinc Hello.kt -include-runtime -d Hello.jar
java -jar Hello.jar
Hello, world!

.kts の使い方と実行例

Hello.kts

println("Hello, world!")

実行コマンド

kotlinc -script Hello.kts
Hello, world!