CodeGym /コース /Python SELF JA /最初のプロジェクト

最初のプロジェクト

Python SELF JA

レベル 3 , レッスン 2

使用可能

8.1 IDEの仕組みの解析

さて、新しいプロジェクトを作成しました。ここで我々が何を見ているのか確認してみましょう。

1. プロジェクトのフォルダとファイルのツリー:

ここには、プロジェクトのフォルダである pythonProject の内容が表示されます。

2. 現在開いているファイル:

これは単に main.py ファイルの内容で、コードのシンタックスがハイライトされています。

3. 上部のメインメニュー:

右上の便利なボタンたち:

「緑の三角形」— プロジェクト開始ボタン。
「虫」— デバッグモードの開始ボタン。
「虫眼鏡」— プロジェクト内検索。
「歯車」— 設定。

4. 左側のサイドメニュー:

ここにはいくつか便利なボタンがあり、特に Terminal ボタンが私たちの関心を引きます。

5. ステータスバー:

ステータスバーの左側には現在開いているファイルのパスが表示されています。右側にはそのエンコーディング: CRLF, UTF-8。

さらに右側には現在のPythonバージョン — Python 3.12.x が表示されています。このプロジェクトが実行されるPythonのバージョンです。異なるバージョンのPythonが複数コンピュータにインストールされている場合に便利です。

8.2 プロジェクトの分析

通常のプロジェクトは、左側のパネルに表示されるファイルで構成されています。これらのファイルは、条件付きで4つの部分に分けることができます。

Pythonコードファイル。このようなファイルには .py という拡張子が付いており、PyCharmはそれらを青と黄色のアイコンでマークします。私たちのプロジェクトには現在、そのようなファイルが1つだけあります — main.py

静的ファイル。 データは含みますがコードは含まないファイルをこのように呼びます。これらはテキストファイル、画像、メディアファイルなどです。現在、私たちのプロジェクトにはありません。

Python仮想環境。 .venv（Virtual Environmentの略）という名前のフォルダには、Pythonファイルといくつかのサービスユーティリティが含まれています。パッケージマネージャ pip も、使用したいサードパーティライブラリをここにダウンロードします。

サードパーティライブラリ（External libraries）。現在、私たちのプロジェクトにはありませんが、ダウンロードすると、PyCharmは必ずここに表示します。

8.3 仮想環境 `.venv`

仮想環境についてもう少し詳しく話しましょう。 .venv は、Pythonプロジェクト用にさまざまな軽量で隔離された仮想環境を作成する機能を提供するPythonのモジュールです。これは、システムライブラリから隔離してプロジェクトの依存関係を管理できるツールです。プロジェクト専用の隔離された部屋があり、そこで家の他の住人に迷惑をかけることなく、個人的なおもちゃや道具を保管できると想像してください。

技術的には、これはシンプルに機能します。プロジェクトフォルダ内にPythonインタプリタのコピーとライブラリ用の別の場所が作成されます。これにより、あるプロジェクト用に特定のバージョンのライブラリをインストールしても、古いバージョンを必要とする別のプロジェクトが壊れることはありません。仮想環境の使用は、終わりのないバージョンの競合から救ってくれる良いマナーです。

PyCharmでの環境管理

PyCharmは通常、これ自体を処理し、すべてを自動的に作成します。しかし、誤って必要なフォルダを削除してしまったり、単に白紙の状態からやり直したい場合があります。これらの設定を手動で管理できることは有用なスキルです。

環境の作成

右下隅にPython接続ステータスが表示されます。そこに Python 3.XX のような表示があれば、インストールは成功しています。開発環境はインタプリタを認識しており、コマンドを実行する準備ができています。

もしそこに No interpreter と書かれている場合は、その文字をクリックしてください。

表示されたメニューで Add New Interpreter を選択し、次に Add Local Interpreter を選択します。
左側の設定で Environment を選択します。中央で、Generate New にチェックが入っていることを確認してください。
OK を押します。エディタは新しいフォルダ .venv を作成し、プロジェクトをすぐにそれに切り替えます。これで、不要なゴミのない完全にクリーンなシステムが手に入りました。

古いものや不要なものの削除

実験が行き詰まり、環境を修復しようとするよりも削除する方が簡単な場合があります。これを行う方法は次のとおりです：

右下隅のPythonバージョンを再度クリックし、Interpreter Settings 項目を選択します。
上部で Python Interpreter フィールドを探します。リストを展開し、Show All 項目を選択します。
PyCharmが認識しているすべての環境のリストが表示されます。削除したいものを選択し、リストの上のメニューにある マイナス ボタンを押します。
重要な点として、PyCharmはこの環境のことを単に「忘れ」、使用を停止します。ディスク上のスペースを物理的に解放するには、通常のエクスプローラーでプロジェクトフォルダに移動し、.venv フォルダを手動で削除する必要があります。

2つ目の環境の作成

エラー：「Already contains Python」

インタプリタ追加メニューに入り Generate new を選択すると、PyCharmが赤い警告を表示し、OK ボタンをブロックする場合があります。これは、エディタが習慣的に、すでに最初の環境で使用されているのと同じ .venv フォルダに新しい環境を作成しようとするために発生します。2つの異なるライブラリセットが1つのフォルダに共存することはできません。

修正方法

新しい「サンドボックス」に一意の名前を付けるだけです。方法は次のとおりです：

以前と同じように Add Local Interpreter メニューを開きます。
Generate new 項目を選択します。
Location フィールドを見てください。おそらく、そこのパスは標準の名前 \.venv で終わっています。
カーソルを行末に置き、そこに任意の数字を追加するだけです。パスの末尾を \.venv_2 に変更し、Enter を押します。
赤い文字はすぐに消えます。OK を押します。

これで、プロジェクトには設定の異なる2つのフォルダが物理的に存在することになり、PyCharmは自動的に新しいバージョンに切り替わります。

環境の切り替え方法

環境をやりくりする能力は重要なスキルです。しかし、ここには落とし穴があります：PyCharmは必ずしも古い環境を自動的に記憶するわけではありません。

2つ目の環境を作成したのに、.venv フォルダはまだプロジェクトにあるのに、1つ目の環境がメニューから消えてしまった、ということがよくあります。この場合、古いPythonをどこで探すべきかPyCharmに指示するだけで済みます。.venv_2 から .venv に切り替える例：

隅にあるPythonバージョンをクリックし、Add New Interpreter -> Add Local Interpreter を選択します。
表示されたウィンドウで、点を Select Existing 項目に切り替えます。
Python Path フィールドで、右側のフォルダアイコンをクリックします。
これで、古いフォルダ（.venv）内のPython起動ファイルを見つける必要があります。パスをたどります：あなたのプロジェクト -> .venv -> Scripts（Windows用）または bin（macOS/Linux用）。
このフォルダ内で python ファイルを選択し、OK を押します。