# 【Kotlin】DevContainer環境セットアップ
> Kotlinを学ぶ際、ローカル環境を汚さずにサクッと試せるのがVS CodeのDev Containerです。
- Canonical: https://c-a-p-engineer.github.io/kotlin-devcontainer-setup/
- Published: 2025-06-24T04:00:00.000Z
- Modified: 2025-06-24T04:00:00.000Z
- Categories: Mobile
- Tags: Mobile, VSCode

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


## Kotlinとは

<a href="https://kotlinlang.org" target="_blank" rel="nofollow noopener">Kotlin公式サイト</a>によると、KotlinはJetBrains社が開発したJVM上で動作する静的型付け言語です。

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

## Dev Container設定ファイル

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

```jsonc
// .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

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

### 実行コマンド

```bash
kotlinc Hello.kt -include-runtime -d Hello.jar
java -jar Hello.jar
```

```bash
Hello, world!
```

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

---

## .kts の使い方と実行例

### Hello.kts

```kotlin:Hello.kts
println("Hello, world!")
```

### 実行コマンド

```bash
kotlinc -script Hello.kts
```

```bash
Hello, world!
```

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