【手順書】WindowsでPython環境構築から実行まで(WSL混在・操作ミス対応付き)
1. 作業の大枠
本手順の全体像は以下の通り。
- PythonがWindowsで実行できることを確認
- WSL(Linux)ではなくWindows環境で作業する
- 作業フォルダを作成・移動
- Pythonファイル(.py)を作成
- PowerShellからPythonを実行
2. Pythonの動作確認
PowerShellまたはコマンドプロンプトで以下を実行する。
python --version
または
py --version
以下のように表示されれば問題なし。
Python 3.x.x
3. Windows環境で作業しているか確認
以下のようなパスであればWindows環境。
C:\Users\ユーザー名\...
以下の場合はWSL(Linux)環境のためNG。
\\wsl.localhost\...
または
username@hostname:~
WSL環境の場合は、PowerShellを起動し直し、以下でホームに移動する。
cd ~
4. 作業フォルダの作成と移動
mkdir 作業フォルダ
cd 作業フォルダ
現在位置は以下のようになる。
C:\Users\ユーザー名\作業フォルダ
5. Pythonファイルの作成
PowerShellで以下を実行。
notepad test.py
メモ帳が開くので、以下を記述して保存する。
print("Hello World")
6. Pythonの実行
python test.py
以下が表示されれば成功。
Hello World
7. 操作ミス・エラーと対処
7.1 PowerShellに直接Pythonコードを書いてしまう
誤り
print("Hello")
エラー例
デバイス PRN を初期化できません
原因
PowerShellはPython実行環境ではないため。
対処
Pythonコードは必ず .py ファイルに記述し、pythonコマンドで実行する。
7.2 ファイルが存在しない
エラー例
can't open file 'test.py'
原因
- ファイルが未作成
- 別フォルダにいる
確認
dir
7.3 test.pyがフォルダになっている
確認
dir
誤り(フォルダ)
d----- test.py
正常(ファイル)
-a---- test.py
対処
Remove-Item test.py -Recurse -Force
再作成する。
notepad test.py
7.4 フォルダの中に入っている
状態
C:\作業フォルダ\test.py>
問題
test.pyをフォルダとして扱っている。
対処
cd ..
7.5 フォルダを実行している
エラー例
can't find '__main__' module
原因
フォルダに対してpythonコマンドを実行している。
7.6 スペースを含むフォルダ名の移動ミス
誤り
cd python work
原因
スペースで区切られて別引数として解釈される。
正しい書き方
cd "python work"
7.7 実行場所の間違い
誤り
C:\Users\ユーザー名>
python test.py
原因
test.pyが存在しないディレクトリで実行している。
対処
cd 作業フォルダ
8. 重要ポイント整理
| 項目 | 内容 |
|---|---|
| Pythonコードを書く場所 | .pyファイル |
| 実行する場所 | PowerShell |
| pythonコマンドの役割 | ファイルの実行 |
| フォルダとファイル | 明確に区別する必要あり |
| WSLとWindows | 別環境として扱う |
9. 完了条件
以下が実行できれば環境構築完了。
python test.py
出力:
Hello World
10. 次のステップ例
- pipによるライブラリ管理
- PowerPoint自動生成(python-pptx)
- Excel操作(openpyxl / pandas)
- Webスクレイピング
以上