タイトル: エクスポートおよびインポート
SEOタイトル: Eclipse プロジェクトのエクスポート / インポート手順｜zip / Git / Maven の使い分け
| この記事の要点 |
|
概要
Eclipse プロジェクトを別 PC や別ワークスペースに渡すための「エクスポート」と「インポート」の手順です。zip でファイルを渡す方式、Git で共有する方式、Maven プロジェクトとして渡す方式の使い分けを解説します。
方式の比較
| 方式 | 適している場面 | 注意点 |
|---|---|---|
| zip アーカイブ | 1 回限りの受け渡し / 教育用配布 | 履歴なし。.classpath に絶対パスが入っていると先方で要修正 |
| Git クローン | チーム開発・継続的に共有 | .gitignore で target/ や .metadata/ を除外する必要 |
| Maven リポジトリ | ライブラリとして公開 | mvn deploy でリポジトリにアップロード |
| ワークスペース丸ごとコピー | 非推奨 | .metadata に PC 固有設定が入っていて壊れやすい |
エクスポート: zip 化する手順
- パッケージ・エクスプローラーでプロジェクトを右クリック → エクスポート (Export...)
- 一般 → アーカイブ・ファイル (General → Archive File) を選択 → 次へ
- 左ペインで対象プロジェクト・サブフォルダを選択（
target/や.metadata/は除外推奨） - 「To archive file」に zip の保存先を指定
- オプション:
- Save in zip format（推奨。tar 形式より互換性が高い）
- Create directory structure for files（チェック推奨）
- 完了を押す
インポート: zip を取り込む手順
- Eclipse で ファイル → インポート (File → Import...)
- 一般 → 既存プロジェクトをワークスペースへ (General → Existing Projects into Workspace)
- Select archive file で zip を選択（または Select root directory でフォルダ）
- 「Projects」リストに対象プロジェクトが表示されるのでチェック
- 「Copy projects into workspace」にチェックを入れるとワークスペース内に複製。チェックを外すと元の場所を参照
- 完了
Maven プロジェクトのインポート
zip ではなく「Maven プロジェクト」として渡された場合は専用インポートを使います:
- ファイル → インポート → Maven → 既存 Maven プロジェクト
- Root Directory に
pom.xmlがある親フォルダを指定 - 表示された pom.xml にチェック → 完了
- 初回は依存ライブラリのダウンロードに数分かかる
- ビルドエラーが残っていれば プロジェクト右クリック → Maven → プロジェクトの更新
Git プロジェクトのインポート (EGit)
- ファイル → インポート → Git → Git からプロジェクト
- 「URI のクローン」で Git URL を入力 → 認証 → ブランチ選択 → ローカル保存先指定
- 「Import existing Eclipse projects」または「Use the New Projects wizard」を選択
- 完了後、ワークスペースにプロジェクトが追加される
除外すべきファイル / フォルダ
zip エクスポート / Git push 時に含めないべきもの:
| パス | 説明 |
|---|---|
target/ | Maven ビルド成果物。再生成可能 |
bin/ | Eclipse のビルド出力 |
.metadata/ | ワークスペース直下にある Eclipse 固有設定 |
.idea/ / *.iml | IntelliJ IDEA 固有設定（混在開発で要注意） |
node_modules/ | npm 依存。再インストール可能 |
.env / application-secrets.properties | 機密情報 |
*.log | ログファイル |
.classpath と .project は基本的に共有しても OK ですが、絶対パス（C:\Users\xxx\...）が入っていないか確認してください。
よくあるトラブル
- インポート後にコンパイルエラー多発: ターゲット・ランタイム / JDK / Maven 依存が解決されていない → 各設定を確認
- 「既存プロジェクト」に何も表示されない: 指定フォルダ直下に
.projectが無い → 1 階層下にプロジェクトがある可能性 - 絶対パスが残っていてリンクエラー:
.classpathを開いて - Git ブランチ名が違う: Eclipse の Git ビューでチェックアウトし直す