この記事の要点

基本は右上の Run ボタン、または Shift+F10 (デバッグは Shift+F9) 引数 / 環境変数 / 作業ディレクトリは Run → Edit Configurations で設定 Python インタープリタは Settings → Project → Python Interpreter で venv / Conda / Poetry を選択 複数の main を切替えたいときは Run Configurations を複数登録 → ツールバーで切替 Jupyter Notebook、Pytest、Django、Flask それぞれ専用 Run Configuration テンプレートあり

最速の実行手順

1. エディタで実行したい .py を開く
2. ファイル内右クリック → Run 'main'
3. または右上の緑の三角 ▶ ボタン
4. キーボードショートカット Shift+F10 で再実行

一度実行すると、その設定が Run Configuration として自動保存され、ツールバー左のドロップダウンから選択できるようになります。

主要ショートカット

操作	Windows / Linux	macOS
Run (実行)	Shift+F10	Ctrl+R
Debug	Shift+F9	Ctrl+D
Run with profile	Alt+Shift+F10	Ctrl+Alt+R
Stop	Ctrl+F2	Cmd+F2
カーソル位置の関数を実行	右クリック → Run	同左
Run Configurations を開く	Alt+Shift+F10 → 0	Ctrl+Alt+R → 0

Run Configuration の編集

Run → Edit Configurations... から、引数や環境変数を細かく設定できます:

項目	用途
Script path	実行する .py ファイル
Parameters	コマンドライン引数 (例: --epochs 10 input.csv)
Environment variables	API_KEY=xxx;DEBUG=1 形式
Working directory	カレントディレクトリ。相対パス読込みに重要
Python interpreter	venv / Conda / Poetry の選択
Add content roots / source roots	PYTHONPATH に追加するか
Run with Python Console	実行後に対話モードに入る
Emulate terminal in output console	tqdm 等の TTY 制御を再現

引数と環境変数の指定例

# train.py
import argparse
import os

parser = argparse.ArgumentParser()
parser.add_argument("--epochs", type=int, default=1)
parser.add_argument("input")
args = parser.parse_args()

print(f"epochs: {args.epochs}")
print(f"input : {args.input}")
print(f"API_KEY: {os.environ.get('API_KEY', 'not set')}")

# Run Configuration:
#   Parameters: --epochs 10 data/train.csv
#   Environment variables: API_KEY=sk-xxx;DEBUG=1

Python Interpreter の選択

プロジェクトで使う Python (=どの venv / Conda 環境を使うか) は次で設定します:

1. File → Settings → Project: xxx → Python Interpreter
2. 歯車アイコン → Add Interpreter
3. 選択肢:
   • Add Local Interpreter → Virtualenv / Conda / Poetry / Pipenv / System
   • On WSL (WSL2 内の Python)
   • On Docker (Pro のみ)
   • On SSH (Pro のみ、リモート開発)

Debug 実行

# main.py
def add(a, b):
    return a + b

def main():
    x = 1
    y = 2
    z = add(x, y)
    print(z)

if __name__ == "__main__":
    main()

1. 行番号の左側をクリックしてブレークポイントを置く (赤丸)
2. Shift+F9 でデバッグ実行
3. 停止位置でローカル変数の値、call stack を確認
4. F8: ステップオーバー / F7: ステップイン / Shift+F8: ステップアウト
5. 条件付きブレークポイント: 赤丸を右クリック → i == 100 等
6. Evaluate Expression (Alt+F8) で式を評価

複数 main の切替

train.py / predict.py / evaluate.py のように複数のエントリポイントがあるとき:

1. 各ファイルで一度ずつ Run → 自動で Run Configuration が作られる
2. ツールバー左のドロップダウンから選択して切替
3. Edit Configurations で並び順や名前を整理
4. Allow parallel run をオンにすると同時実行可

Jupyter Notebook の実行

PyCharm Professional は Jupyter (.ipynb) を直接編集・実行できます。Community 版は対応していません。

# プロジェクトに jupyter を入れる
pip install jupyter ipykernel

# .ipynb を開けばセルごとに Run ボタンが表示される
# Shift+Enter: セル実行して次へ
# Ctrl+Enter : セル実行 (留まる)

Pytest の実行

# test_calc.py
def add(a, b):
    return a + b

def test_add():
    assert add(1, 2) == 3
    assert add(-1, 1) == 0

1. Settings → Tools → Python Integrated Tools → Default test runner = pytest
2. テスト関数の左側に緑の ▶ が出る → クリックで個別実行
3. ファイル全体は Ctrl+Shift+F10
4. 失敗テストだけ再実行は Run Tool Window 右上のアイコン

ターミナル統合

Alt+F12 で組み込みターミナルが開きます。プロジェクトの venv が自動で activate されるので、python main.py や pytest をそのまま実行できます。

FAQ

Q: 実行ボタンがグレーアウトしている
A: ファイルが Python ファイルとして認識されていません。右下の言語表示を確認、または Settings → File Types に .py が登録されているか。

Q: ModuleNotFoundError が出る
A: (1) Run Configuration の Python interpreter が間違っている、(2) Working directory がプロジェクトルートになっていない、のいずれか。Edit Configurations から修正してください。

Q: print の出力が遅れて表示される
A: バッファリングです。print(..., flush=True) か、Run Configuration の Emulate terminal in output console を ON に。