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

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

Kotlinとは

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

Javaとの相互運用性が高く、簡潔で安全な文法を提供
サーバーサイド、Android、マルチプラットフォームで活躍

Dev Container設定ファイル

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// .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

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

実行コマンド

1
2
kotlinc Hello.kt -include-runtime -d Hello.jar
java -jar Hello.jar

1
Hello, world!

ポイント：kotlincでJARを生成し、java -jarで起動。
注意：JVM起動オーバーヘッドがあるため、やや時間がかかる。

.kts の使い方と実行例

Hello.kts

println("Hello, world!")

実行コマンド

1
kotlinc -script Hello.kts

1
Hello, world!

ポイント：kotlinc -scriptで直接実行。
メリット：コンパイル不要で起動が高速、スクリプト的な開発に最適。