VisualStudioCodeでPython環境構築まとめ（インストール、Powershellの設定、仮想環境構築）

# はじめに
VisualStudioCodeを用いてPython環境を構築する際に
色々と躓きポイントがありました。

知りたかった情報が、知りたかった順に全てまとまった記事が見当たらなかったので
自分用のメモとして記事を作成いたしました。

それぞれの情報は以下のQiita記事から参照しています
- [Visual Studio Codeのインストールと設定](https://qiita.com/furu38/items/6776acba6621012ee475)
- [Python+VSCodeにおすすめの拡張機能](https://qiita.com/momotar47279337/items/73157407ae824751afc4)
- [PYTHON環境構築するなら絶対に理解しておかないといけない注意点](https://qiita.com/oxlunaxo/items/ca7ffc059be3ffc17622)
- [Windows10のVSCodeでvenvを利用するときの注意点](https://qiita.com/Avocado/items/3e71870815d6c54c1eea)
- [(初心者向け)WindowsでPythonの仮想環境の構築](https://qiita.com/toki_mwc/items/f2e81bdf244cab46cf5e)
- [Powershellでのvenvの操作方法](https://qiita.com/teri_man95/items/d594b9c88914177b8465)
- [Python 仮想環境（venv）作成・削除](https://qiita.com/hrmc/items/264857074b0c26dfeeaf)

# 流れ
以下の流れでPython環境構築を説明していきます
1. VSCodeのインストール(普通にインストールするだけ)
1. VSCodeの拡張機能をインストール(普通にインストールするだけ)
1. Pythonのインストール(Pathを通し忘れると躓く)
1. PowerShellのポリシーを変更(これをやらないと謎のエラーに悩む)
1. PowerShellで仮想環境を構築してパッケージをインストール(上記ができていれば躓かない)
1. Pythonの実行(あとは実行するだけ)

# VSCodeのインストール
(普通にインストールするだけ)
まずは肝心のVSCodeをインストールしていきます

やることは単純で
- [こちらのサイト](https://code.visualstudio.com/download)からインストーラーをダウンロードして
- 上記のインストーラーを実行する

だけです。


以下がダウンロードサイトの見た目です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/1f57af45-1ec9-b49c-1d48-1cfc19db5a05.png)

インストーラーの実行では色々と聞かれますが、
基本はデフォルトのまま「次へ」を押すだけで問題はなかったです。

詳しくは@furu38(ryuta furukawa)さんの[こちらの記事](https://qiita.com/furu38/items/6776acba6621012ee475)を参照ください。

# VSCodeの拡張機能をインストール
(普通にインストールするだけ)
次にVSCodeの拡張機能をインストールしていきます。

こちらもやることは単純で
- VSCodeを起動し、左側のアイコンから拡張機能メニューを開き
- 「入れたい拡張機能を検索して
- インストールする

だけです


以下が拡張機能メニューを開くアイコンです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/a7516c84-e2f3-efe0-0fed-b5a48c3266a9.png)


Pythonを使用する場合は、ひとまず「Python」と検索して一番上にくる
「Python」をインストールします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/2bebf022-87e9-9840-5087-08eb1e61c1c2.png)


その他の便利な拡張機能に関しては、@momotar47279337さんの[こちらの記事](https://qiita.com/momotar47279337/items/73157407ae824751afc4)をご参照ください。

# Pythonのインストール
(Pathを通し忘れると躓く)
基本は
- [こちらのサイト](https://www.python.org/downloads/windows/)からインストーラーをダウンロードして
- 上記を実行する

だけですが、いくつか躓きポイントがあります。

1. まず、どのインストーラーが良いのか迷います
基本は、最新版の「Windows installer(32bit)」か「Windows installer(64bit)」を使えばよいと思っています
自信がないので、詳しくは@oxlunaxoさんの[こちらの記事](PYTHON環境構築するなら絶対に理解しておかないといけない注意点)をご参照ください。
1. 次に、インストールの一番最初に
**「Add Python 3.x to PATH」にチェックを入れ忘れると後で面倒です**
忘れずにチェックを入れてください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/b401b470-9646-b00c-56f5-2302ef23b7c2.png)

# PowerShellのポリシーを変更
(これをやらないと謎のエラーに悩む)
詳しくは@Avocadoさんが[こちらの記事](https://qiita.com/Avocado/items/3e71870815d6c54c1eea)で紹介している通りです。

次の項目以降において、PowerShell上でPythonを実行していくのですが、
その際に、デフォルトの設定ではうまくいかないので、「PowerShellの実行ポリシー」を編集していきます。
これをやっておかないと、以下のようなエラーメッセージが出てきて???となります。
> ~このシステムではスクリプトの実行が無効になっているため~

実行ポリシーの変更方法やポリシーの種類も調べるといくつかやり方が出てくるのですが、詳しくは上述のRefにお任せして、私が実行した流れだけご紹介します。
- 管理者権限でPowerShellを開く
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/79855a81-6d29-3323-a660-669ef8b353c4.png)
- 以下を実行（セキュリティが気になる人はしっかり各ポリシーを確認してください）
```
Set-ExecutionPolicy RemoteSigned
```

# PowerShellで仮想環境を構築してパッケージをインストール
(上記ができていれば躓かない)
次に、@toki_mwcさんが[こちらの記事](https://qiita.com/toki_mwc/items/f2e81bdf244cab46cf5e)で紹介されている通りに仮想環境を構築していきます。

詳しくは上記の記事に任せるとして、流れだけ書くと
- どのフォルダで作業をするか決める(パスに日本が入らないように注意)
- PowerShellを開く(VsCode上でも実行できますが)
- 仮想環境を作りたいディレクトリまで移動
- 以下を実行して仮想環境を作成（つけた名前のディレクトリが生成されるはず）
```
python -m venv {好きな仮想環境名}
```
- 以下を実行して仮想環境を有効化
```
.\{上記でつけた仮想環境名}\Scripts\activate
```
- 上記の処理で仮想環境が有効化されている状態で、pipを使用してほしいパッケージをインストール
```
pip install {パッケージの名前}
```

もし上記の流れで作成した環境を削除したくなった場合は、
@hrmcさんが[こちらの記事](https://qiita.com/hrmc/items/264857074b0c26dfeeaf)で書かれているように、
以下のコマンドで削除することができます。
```
python -m venv --clear {上記でつけた仮想環境名}
```

# Pythonの実行
(あとは実行するだけ)
色々とやり方はありますが、上記の操作の流れのままPythonを実行するのであれば以下のような流れが例として挙げられます。
- (仮想環境を有効化している状態で)以下を実行してVSCodeを開く
```
code .
```
- VSCodeが立ち上がるので、「新しいファイル」からPythonファイルを作成して
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/312df8aa-cc5a-ba96-baa2-403726fb17b5.png)
- 何か適当にコードを書いて
- 「Ctrl + S」で保存して
- 右上の実行ボタンで実行
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/753878/e45e24df-836a-9905-2171-3dd4246b5a77.png)

今回の記事は環境構築までが主題なので、VSCodeの操作自体は細かく説明しませんが、
もっとスマートに実行する方法もあるそうです。[こちらのサイト](https://pouhon.net/vscode-excute/1636/)などをご参照ください。

# 最後に
VSCodeでPythonの環境構築をする方法について私なりにまとめてみました。
誰かの手助けになっていれば幸いです。

ちなみに、最近はCursorというAIを活用した新しいエディタがでてきていて、もうVSCodeは終わり？みたいな話も耳にします。
私も早めにキャッチアップしていきたいと思います。