【完全版】Pythonのimportの使い方を基礎から徹底解説!エラー対策も網羅
ちなみに、`import`の仕方には、実行ファイルからの相対的な位置で指定する相対インポート(例: `from . import hoge`)と、プロジェクトのルートからの絶対的な位置で指定する絶対インポート(例: `from myapp.modules import fuga`)という考え方もありますが、まずは基本的な`from ディレクトリ名 import モジュール名`の使い方に慣れるのがおすすめです。
Pythonのimportに関するベストプラクティスと注意点
`import`文はファイルの先頭に書こう グループ化して並べよう- 複数の`import`文を書くときは、以下の順序でグループ化し、各グループ間は一行空行を入れると見やすくなります。
- 標準ライブラリ(`math`, `os`, `sys`, `datetime`など)
- サードパーティライブラリ(`pip`でインストールしたもの。`pandas`, `requests`, `numpy`など)
- 自作モジュール(自分で作った`.py`ファイル)
開発の途中で使わなくなったモジュールの`import`文が残っていると、コードが読みにくくなるだけでなく、無駄な読み込みが発生する可能性もあります。定期的にコードを見直して、不要な`import`文は削除する習慣をつけましょう。これらの作法は、Pythonの公式スタイルガイドであるPEP 8でも推奨されています。読みやすいコードは、将来の自分や他の開発者への思いやりです。少しずつ意識してみてくださいね。
pipとimportの関係性 - Pythonライブラリ導入の流れ
- `pip install` は「お店(インターネット)から、便利な道具(ライブラリ)を買ってきて、自分の道具箱に入れる」作業。
- `import` は「作業を始めるときに、道具箱から今日使う道具(ライブラリ)を取り出して、作業台に並べる」作業。
- ライブラリを探す まず、「こんな機能が欲しいな」と思ったら、インターネットでPythonのライブラリを探します(例: 「Python 画像処理 ライブラリ」で検索)。
- インストール (`pip install`) 使いたいライブラリが見つかったら、コマンドプロンプトやターミナルで `pip install ライブラリ名` を実行します。これで、インターネット上(PyPIという場所が有名です)からライブラリのファイルがダウンロードされ、あなたのPython環境にインストールされます。この作業は、通常、そのライブラリを使う最初の1回だけ行います。
- プログラムで読み込む (`import`) インストールが完了したら、いよいよPythonのプログラム(`.py`ファイル)の中で `import ライブラリ名` と書きます。これで、インストールしたライブラリの機能が、あなたのプログラム内で使える状態になります。`import`は、そのライブラリを使うプログラムファイルごとに書く必要があります。
- 機能を使う `import`で準備ができたら、あとは `ライブラリ名.関数名()` のような形で、そのライブラリが提供する便利な機能を使っていく、という流れです。
つまり、`pip install` はライブラリを自分のPC環境に準備する一度きりの(ことが多い)作業で、`import` はプログラムを書くたびに「この準備したライブラリを使いますよ!」と宣言する作業、という関係性です。
【まとめ】Pythonのimportの使い方をマスターして開発効率を上げよう
- `import`は他のファイル(モジュールやライブラリ)の機能を使うための宣言。
- 基本は`import モジュール名`、使うときは`モジュール名.機能名`。
- `from モジュール名 import 機能名`で特定の機能だけを取り込める(モジュール名省略可)。
- `import モジュール名 as 別名`で短い名前を付けられる。
- `ModuleNotFoundError`が出たら、スペルミス、未インストール、パスの問題などを疑う。
- 自作の`.py`ファイルも`import`できる!整理整頓に役立つ。
- `import`文はファイルの先頭に、グループ化して書くと綺麗。`*`は使わない。
- `pip install`でライブラリを準備し、`import`でプログラムに読み込む。