Django プロジェクトを Eclipse で開発する方法

Python の Web アプリケーション・フレームワークである Django を使って開発する際、コード・エディタとして Eclipse を使いたい場合の手順を紹介。ざっくりいうと、コマンドでプロジェクトを作成した後、Eclipse でインポートする手順となる。

なお当方の開発環境は Mac だが、Eclipse の使える環境であれば同じ手順が利用可能。

開発環境

  • Eclipse 4.4.1
  • PyDev 3.9.1

Eclipse&PyDev インストール

ググると情報がたくさんあるため、詳細は割愛。Eclipse はこちらよりダウンロードし、解凍しておく。Package は好みだが、個人的には Eclipse を Python エディタとして使いたいだけなので最小構成の Eclipse SDK をこちらからダウンロードするのがオススメ。

Eclipse 起動後、初回はワークスペースの置き場所を聞かれるが、適当な場所を指定する。ソースコードの置き場所となるため、バックアップのとりやすいところを指定するのがオススメ。

起動した後、[Help] メニュー > [Eclipse Marketplace] より[Find:] と書かれた検索窓に「pydev」と入力し、検索。ヒットした PyDev プラグインを [Install] ボタン押下によりインストールを行う。[Next] や [Accept] といったボタンを駆使してインストールし、最後に Eclipse を再起動する。

再起動した後、[File] メニュー > [New] > [PyDev Project] と表示されていれば OK(表示を確認するだけで、今は選択しなくてよい)。

Django プロジェクトの作成

過去のこちらの投稿を参考に、Django プロジェクトを作成する。先ほど作成した Eclipse のワークスペース・フォルダ直下に作成すること。

Eclipse に Django プロジェクトを作成

手順としては新規にプロジェクトを作成しているが、実際には作成済みのプロジェクトフォルダがあるためインポート扱いとなる。

  1. Eclipse で [File] メニュー > [New] > [Other] > [PyDev] > [PyDev Django Project] を選択
  2. [Project name:] に作成した Django プロジェクト名を入力すると、画面上部の「Create a new Pydev Django Project.」が「Project location contains existing Python files. The created project will include them.」の表示に変わる。 [Next] > [Next] > [Finish] とボタンをクリック。
  3. PyDev Package Explorer ビュー等に作成した Django プロジェクトが表示されたら OK。

なお Django アプリケーションは、プロジェクトルートで右クリックし、[Debug As | Run As] > [PyDev: Django] を選択すると、開発機上で Web アプリケーションが起動し、http://127.0.0.1:8000/ でアクセスし動作確認が可能となる。

import で「Unresolved import: 」Error となったり、サーバ実行時に「ImportError: No module named  <パッケージ名>」Error となった場合の対処方法

virtualenv を使って pip install 等でライブラリを追加すると、Eclipse 上からはライブラリのパスが参照できないため、import できない旨のエラーが表示される場合がある。その場合の対処方法は以下の通り。

  1. プロジェクトルートで右クリックし、[Properties] を選択。
  2. [PyDev – PYTHONPATH] > [External Libraries] > [Add source folder] と選択する。
  3. virtualenv 上で追加したライブラリのパッケージディレクトリ (<Eclipse のワークスペース>/<project 名>/<virtualenv 環境名>/lib/python2.7/site-packages) を辿って [開く] を選択する。
  4. [OK] を選択してダイアログを閉じた後、import 関連のエラーが出なくなればOK。

yktmnb について

IT土方兼社畜を生業としています。 入社以来 Java を用いた社内向け Web アプリの開発に携わっていました。 最近は IaaS 関連の仕事をしています。 個人的に Android アプリ開発をしたり、ゆるべんという勉強会 (http://wooven.org/) をのんびりとやってます。
カテゴリー: Django, Eclipse, Mac, Python パーマリンク