WindowsのVSCodeでPythonの仮想環境を作る手順

#0. さいしょに
Python初心者です。
タイトルの通りWindowsでPythonを動かすにあたり、いろいろな試行錯誤を経てVSCodeでの環境に落ち着いたので、その手順を記録しておきます。
OSはwindows10です。


#1. PythonとVSCodeのダウンロードとインストール
##1-1. Pythonをダウンロード
1. [www.python.org](https://www.python.org/)へアクセス。
2. `Python` > `Downloads` > `Windows`と進む。
3. ダウンロードリンクの一覧がずらっと並んでるので、バージョンの新しいものを探す。
4. インストーラーの種類が複数ある中で、`Windows x86-64 executable installer`を選択。

この記事では`3.8.2`をダウンロードしました。

**Pythonをインストール**
1. インストーラー（.exe）を実行。
2. とくに問題ないと思うので省略します。

##1-2. VSCodeをダウンロード
1. [code.visualstudio.com](https://code.visualstudio.com/download)へアクセス。
2. 窓（Windows）| ペンギン（Linux） | リンゴ（Mac）の絵が並んでいる。
3. `Windows`の`User Installer`を選んでダウンロード。

この記事では、`64bit`をダウンロードしました。

**VSCodeをインストール**
1. インストーラー（.exe）を実行。
2. とくに問題ないと思うので省略します

次は、仮想環境を作っていきます。

#2. VSCode上にPython仮想環境を作る
##2-1. 拡張機能を追加する
###2-1-1. 日本語化
1. VSCodeを起動する
2. `Ctrl`+`Shift`+`X`で拡張機能を表示する
3. `Japanese Language Pack for Visual Studio Code`を検索して、インストールする
4. メニューが日本語になる

これ以降、
VSCodeのメニューは日本語化されているものとして説明しますね。

###2-1-2. Python
1. `Ctrl`+`Shift`+`X`で拡張機能を表示する
2. `Python`を検索
3. いろいろな拡張が出てくるので、`Microsoft`の拡張を選ぶ（おそらく一番最初に表示されています）

これはVSCode上でPythonを動かすための拡張機能です。

##2-2. Python用のフォルダを準備する
ここでは、WindowsのPCに下記のドキュメント構造を作る手順として記載します。

`C:\Users\\[user]\Documents\Python\dev01`
（`[user]`部分はユーザー名です）

###2-2-1. Pythonフォルダを作成
1. PC > ドキュメント >を開く
2. `Python`というフォルダを新規作成する

この配下にdev01というフォルダを用意していきますが、まだ作成しないでください。
ここからは、VSCode上で操作をしていきます。

##2-3. VSCodeで仮想環境を作る
###2-3-1. フォルダを開く
1. VSCodeを起動する
2. `ファイル` > `フォルダを開く`  を選択
3. 先ほど作った、`Python`フォルダを選択する
4. エクスプローラーが出現する

この中に、`dev01`という仮想環境を作っていきます。

###2-3-2. Powershellでvenvする
1. `表示` > `ターミナル`　を選択
2. ターミナルの画面が現れて、「`powershell`」が出ます。

Powershellはコマンドを使って操作するWindowsのツールです。
これをVSCodeから操作をすることができます。

ターミナル画面の最終行に
`PS C:\Users\\[user]\Documents\Python > `
という文字列がありますね。この後に、コマンドを入力します。

3. `python -m venv dev01` と入力して`Enter`
4. `dev01` という開発環境が作成されます。

エクスプローラーの中にも、dev01配下に下記のフォルダが見えていればOKです。

* PYTHON
    * dev01
        * include
        * Lib
        * Scripts

####venvについて
いまvenvというコマンドでPythonの仮想環境を作成しました。
Pythonを動かすためのスクリプトやライブラリなどを`dev01`というフォルダの中に作成した感じです。
`dev01`としましたが、必要に応じて`dev02`、`dev03`などの別の環境も作ることを想定しています。


#3. 環境設定
環境設定の決まった手順があるのか分かりませんが、
行き当たりばったりでPythonのファイル（.py）を実際に作成しながら必要な設定をしていきます。

##3-1. Pythonファイルを作成する
###3-1-1. 新規ファイル作成
1. VSCodeで`ファイル` > `新規ファイル`を選択
2. あたらしいファイルが出現します。
3. このまま保存してもよいのですが、せっかくなので「hello world!」をコーディングします。

```python:work_00_hello.py
print('Hello World!')
```

###3-1-2. Pythonファイルとして保存する
1. `Ctrl`+`S`で保存をします
    2. 保存するフォルダは、`dev01`の配下です。
    3. ファイル名は、`work_00_hello.py` とします。
    4. `.py`で保存することで、VSCode上でもPythonファイルだと認識されて、拡張機能のインストールをすすめるメッセージが表示されるので、それらをインストールしていきます。

##3-2. 各種インストール
###3-2-1. pylint 
1. 「`Linter pylint is not installed.`」などのメッセージが表示されることがあります。
2. これは、足りない拡張機能のインストールが推奨されているので、インストールボタンを押してください。

###3-2-2. pipのアップグレード
1. ターミナルに「`You should consider upgrading via the 'python -m pip install --upgrade pip' command.`」などのメッセージが表示されることがあります。
2. pipをアプデしましょう、ということなので、次にこのコマンドを入力しましょう。
3. `ターミナル` > `Python`を選択
    4. おそらく今はPythonになっている状態かと思います
    3. pyファイルを実行すると、ターミナルがPythonになります
4. `python -m pip install --upgrade pip`と入力して`Enter`
5. pipの最新版がインストールされます


##3-3. インタープリターの選択
インタープリターはPythonのコードを翻訳して実行できるようにする仕組みです。
python.exeというインタプリターを使うのですが、場合によってこれが複数のディレクトリに存在します。
複数あるPython.exeのうち、`dev01環境のPython.exeを指定する`、という意味の設定をします。

1. `Ctrl`+`Shift`+`P`でコマンドパレットを表示します
2. 表示されたボックスに「`select`」と入力して`Enter`を押す
3. Pythonのインタープリターが１つもしくは複数表示されます
4. 「`Python 3.\*.\* 64-bit('dev01':venv)`」を選択します

これで、先ほど作ったdev01環境のインタープリターが選択されました。

##3-4. 環境の確認
VSCodeの左下に、現在の環境が表示されます。
`Python 3.*.* 64-bit ('dev01':venv)`
と表示されていればOKです。

##3-5. ワークスペースの作成
いま、VSCodeのエクスプローラー上は、`PYTHON`というフォルダが開かれていると思います。
この状態を、ワークスペースとして保存します。
1. `ファイル` > `名前を付けてワークスペースを保存`
    2. 保存先：`ドキュメント` > `Python` の直下を選択します
    3. 名前：ここでは、`Python`というワークスペース名として保存します。
4. Pythonフォルダ内に、`Python.code-workspace`が保存されました。

これで環境設定は完了です。

#4. Hello World!
さきほど作った最初のPythonファイルを動かしてみます。

1. エクスプローラーから`work_00_hello.py`を開く
2. エディタ右上の`プレイボタン`を押す（開いているPythonファイルが実行される）
3. ターミナルに「`Hello World!`」が表示されたらOKです。

以上で、WindowsのVSCodeでPythonの仮想環境ができあがりです。
何度か試してこうなりましたが、環境やバージョンによっては異なる手順になるかもしれません。

ありがとうございました。

#5. 参考にさせて頂いたサイト
##Qiita
[python環境準備(python3+vscode)について](https://qiita.com/PureViewMMAV/items/b2ec64a6a03f50cd820f)

##@markIT
[Visual Studio Codeの設定「虎の巻」：Python編](https://www.atmarkit.co.jp/ait/articles/1711/24/news034.html)
[VS CodeでPythonするために必要なこと](https://www.atmarkit.co.jp/ait/articles/1805/22/news043.html)

##visualstudiocode
[Getting Started with Python in VS Code](https://code.visualstudio.com/docs/python/python-tutorial)

##python
[venv --- 仮想環境の作成](https://docs.python.org/ja/3/library/venv.html)