turborepo package unexpected token exportの解決方法【2025年最新版】

エラーの概要・症状

turborepo package unexpected token export というエラーメッセージは、TypeScriptを使用したプロジェクトで発生することがあります。このエラーは、特にモジュールのインポートやエクスポートに関連する問題が原因であることが多いです。具体的には、アプリケーションが期待しているモジュールの形式と、実際に提供されているモジュールの形式が一致しない場合に発生します。

このエラーが発生すると、開発者はアプリケーションを正常にビルドしたり実行したりできなくなります。特に、TypeScriptで書かれたコードをJavaScriptにトランスパイルする際に、エクスポートの形式が一致しない場合、アプリケーションが正しく動作しないことがあります。これにより、開発者はエラーメッセージを解決するために多くの時間を費やすことになり、業務の進行が妨げられることもあります。

このエラーが発生する原因

このエラーが発生する主な原因はいくつかあります。以下にその詳細を説明します。

1. モジュール形式の不一致: TypeScriptでは、モジュールをCommonJS形式やESモジュール形式で書くことができます。プロジェクトがこれらの形式のどちらかを選択している場合、TypeScriptの設定ファイル（tsconfig.json）で指定したモジュール形式と、実際のエクスポート形式が一致しないとエラーが発生します。

2. トランスパイル設定の不備: TypeScriptを使用している場合、ビルドプロセスでTypeScriptコードをJavaScriptにトランスパイルする必要があります。この際、トランスパイルされるファイルの出力先や、含めるファイル、除外するファイルを正しく設定しないと、エラーが発生することがあります。

3. 依存関係のビルド順序: turborepoのようなモノレポ構成では、依存パッケージのビルド順序が重要です。依存関係が正しくビルドされていない場合、エクスポートされるモジュールが正しく解決されず、エラーが発生することがあります。

4. TypeScriptのバージョン問題: 特定のTypeScriptのバージョンでは、特定の機能や構文がサポートされていない場合があります。これにより、意図した通りにトランスパイルされず、エラーが発生することがあります。

解決方法1（最も効果的）

手順1-1: `tsconfig.json`の設定を確認・修正する

まず、プロジェクトのルートディレクトリにあるtsconfig.jsonファイルを開きます。以下のように設定されていることを確認してください。