Windowsマシン上でVisual Studio Codeとpipenvを使ってPythonの仮想実行環境を構築する方法（Jupyter notebookも）
•Als PPTX, PDF herunterladen•
1 gefällt mir•2,867 views
Windowsマシン上でAnacondaをインストールすることなく，Visual Studio CodeとバニラのPythonのみを使ってPythonの実行環境を構築する方法を解説． さらに，pipenvを使った仮想実行環境の構築方法やJupyter notebookの作成・実行方法も解説．
Empfohlen
Weitere ähnliche Inhalte
Was ist angesagt?
Was ist angesagt? (20)
Ähnlich wie Windowsマシン上でVisual Studio Codeとpipenvを使ってPythonの仮想実行環境を構築する方法（Jupyter notebookも）
Ähnlich wie Windowsマシン上でVisual Studio Codeとpipenvを使ってPythonの仮想実行環境を構築する方法（Jupyter notebookも） (20)
Mehr von Daichi Kitamura
Mehr von Daichi Kitamura (20)
Windowsマシン上でVisual Studio Codeとpipenvを使ってPythonの仮想実行環境を構築する方法（Jupyter notebookも）
- 1. Windowsマシン上で Visual Studio Codeとpipenvを使って Pythonの仮想実行環境を構築する方法 （Jupyter notebookも） 2020年3月10日作成 Daichi Kitamura
- 2. • Windowsマシン上で，Anacondaを使わず，VSCode（エ ディタ）とPython（インタプリタ）のみで，Pythonを実行で きる環境の構築を解説 – 有名なPython環境インストーラのAnacondaは使わない • 使わない理由は次スライド • pipenvを利用したディレクトリ完結型の仮想環境の構築 方法も解説 – インストールするパッケージの管理がディレクトリ単位になるの で，PC本体の実行環境を汚すことなく開発できる • Jupyter notebookを実行する環境の構築方法も解説 – Jupyter notebookはセル単位でコードの実行・確認ができる初 学者向けの有名なエディット環境 本資料の目的 2
- 3. • PythonとVSCodeについて • VSCode+Pythonの実行環境の構築方法 – VSCodeのインストールと初期設定 – Pythonのインストールと初期設定 – VSCode+Pythonの環境構築・実行・デバッグ • pipenvによる仮想実行環境の構築方法 – 仮想実行環境とは – pipenvのインストールと初期設定 – pipenvによる仮想環境の構築・実行 • Jupyter notebookの実行環境の構築方法 – Jupyter notebookとは – Jupyter notebookのインストール – Jupyter notebookの実行 目次 3
- 4. • PythonとVSCodeについて • VSCode+Pythonの実行環境の構築方法 – VSCodeのインストールと初期設定 – Pythonのインストールと初期設定 – VSCode+Pythonの環境構築・実行・デバッグ • pipenvによる仮想実行環境の構築方法 – 仮想実行環境とは – pipenvのインストールと初期設定 – pipenvによる仮想環境の構築・実行 • Jupyter notebookの実行環境の構築方法 – Jupyter notebookとは – Jupyter notebookのインストール – Jupyter notebookの実行 目次 4
- 5. • Python（ぱいそん）の特徴 – 高水準汎用スクリプト言語（1行ずつ実行） – 動的な型付け – 機械学習・深層学習分野で目覚ましく普及 – ライブラリが豊富，情報が豊富 • 実行環境構築がめんどくさい場合が多い – 本資料では高機能エディタのVisual Studio Codeからバニラの Pythonを実行するような環境の構築手順を紹介 – 「とりあえずAnaconda入れとこ」は簡単だが危険 • AnacondaはPython環境の一括インストーラ（IDEからパッケージまで） • Anaconda独自の仮想環境パッケージ管理ソフトの「conda」は，Python 純正のパッケージ管理ソフトの「pip」と共存すると混乱の元になる – condaだけで済めば良いが，pipでなければインストールできないパッケージが存在 • condaでnumpyという計算用パッケージをインストールすると，線形代数 演算ライブラリ（BLAS）がOpenBLASではなくIntel MKLになり低速 Python 5
- 6. • VSCodeの特徴 – 汎用高機能テキストエディタ – 開発はマイクロソフト – 豊富な拡張機能により，あらゆるテキスト記述に適合 • C，C++，Java，HTML，CSS，MATLAB，Pythonなどなど・・・ • VSCode＋Python – Pythonの統合開発環境 （IDE）の機能 • 実行・デバッグ – 一番シンプルなPython 開発環境ではなかろうか Visual Studio CodeとPython 6
- 7. • PythonとVSCodeについて • VSCode+Pythonの実行環境の構築方法 – VSCodeのインストールと初期設定 – Pythonのインストールと初期設定 – VSCode+Pythonの環境構築・実行・デバッグ • pipenvによる仮想実行環境の構築方法 – 仮想実行環境とは – pipenvのインストールと初期設定 – pipenvによる仮想環境の構築・実行 • Jupyter notebookの実行環境の構築方法 – Jupyter notebookとは – Jupyter notebookのインストール – Jupyter notebookの実行 目次 7
- 8. • ダウンロード – https://code.visualstudio.com/download/ – 各プラットフォームに合わせてダウンロード（64bit版） VSCodeのインストール 8
- 9. • インストール – ダウンロードしたインストーラをダブルクリック – 使用許諾契約書に同意して「次へ」 VSCodeのインストール 9
- 12. • インストール – 追加タスクの選択を好みで設定して「次へ」 • コンテキストメニューに[Code で開く]を追加すると，右クリックで起動でき るので便利 VSCodeのインストール 12
- 13. • インストール – 最終確認をして「インストール」 • インストール後，VSCodeが自動起動する – 一度閉じて Windows再起動 VSCodeのインストール 13
- 15. • 日本語化の拡張機能 – Search extensionsに「Japanese」と入力し「Install」をクリック VSCodeの拡張機能のインストール 15
- 16. • 日本語化の拡張機能 – インストール後の画面右下のRestart Nowをクリックして再起動 VSCodeの拡張機能のインストール 16
- 18. • Hot exit機能をオフ – ファイル未保存でもVSCodeを終了できる機能（混乱の元） VSCodeの推奨設定 18
- 19. • Hot exit機能をオフ – 設定タブの「設定の検索」に「hot exit」と入力し「off」に設定 VSCodeの推奨設定 19
- 20. • ダウンロード – https://www.python.org/downloads/ – 各プラットフォームに合わせてダウンロード • Pythonのバージョンは3.6.10か3.7.6にする方が無難（2020年3月現在） • 新しいとPythonのライブラリやパッケージが対応していない可能性 Pythonのインストール 20
- 21. • ダウンロード – https://www.python.org/downloads/ – x86-64（64bit版）なら何でも良いが，executable installerを選 択してダウンロード • LinuxやMacの場合は専用のものを選択 Pythonのインストール 21
- 22. • インストール – ダウンロードしたインストーラをダブルクリック – 「Customize installation」をクリック Pythonのインストール 22
- 24. • インストール – 「全ユーザにインストール」，「Pythonパスを環境変数に設定」 を選択して「Install」（全ユーザにインストールしないとpipenvでパスが通らずこける） – インストール完了後「Close」 Pythonのインストール 24
- 30. • 実際にPythonスクリプトを作成し実行してみる – 適当にプログラムを書いてみましょう – 保存してF5キー（実行）を押すとデバッグメニューが表示 • 「Python File」をクリック（あるいはそのままエンター） VSCode+Pythonの環境構築・実行 30 ファイルが未保存のときは白丸 Ctrl+sで保存
- 31. • 実際にPythonスクリプトを作成し実行してみる – ターミナル（Windows PowerShell）が表示され，その上で Python実行コマンド（「python ./test.py」）が実行されて結果が 表示される – おめでとうございます（うごきました） VSCode+Pythonの環境構築・実行 31 実行結果
- 32. • 実行中にデバッグしてみる – Pythonスクリプト「inc.py」を新規作成し下記を入力して保存 – F5→エンターで実行すると結果が表示される VSCode+Pythonのデバッグ 32
- 35. • VSCodeの新規ターミナルの起動 – メニューバーの「ターミナル」→「新しいターミナル」 • ターミナルの過去の文字列（コマンドログ）を消す – 「clear」と入力しエンター • 対話モードのPythonインタプリタ – VSCodeのターミナル（Windows PowerShell）上で「py」と打つ と対話モードのPythonインタプリタが起動 • 1行ずつ実行できるのでちょっとした確認などに便利 • 対話モードは「exit()」で終了 その他の情報 35
- 36. • PythonとVSCodeについて • VSCode+Pythonの実行環境の構築方法 – VSCodeのインストールと初期設定 – Pythonのインストールと初期設定 – VSCode+Pythonの環境構築・実行・デバッグ • pipenvによる仮想実行環境の構築方法 – 仮想実行環境とは – pipenvのインストールと初期設定 – pipenvによる仮想環境の構築・実行 • Jupyter notebookの実行環境の構築方法 – Jupyter notebookとは – Jupyter notebookのインストール – Jupyter notebookの実行 目次 36
- 37. • Pythonは「パッケージ」と呼ばれる追加ライブラリをイン ポートすることで，使える関数等が増える – 数値計算にはnumpy，データ操作にはpandas等 – 「import numpy as np」を宣言するとnumpyの関数がnp.xxxと いう形で使える • C言語の#includeでヘッダーファイルを読み込むのと同じ概念 • Pythonでは「pip」と呼ばれるパッケージ管理ソフトを使っ て各パッケージをインストール・アンインストールする – ターミナルで「pip install numpy」を実行すれば，numpyがイン ストールされる • 後述のバージョンを指定していないので最新版のnumpyが入る – ターミナルで「pip list」を実行すれば，現在インストールされてい るパッケージ一覧が表示される – 「pip uninstall numpy」でnumpyをアンインストールできる 仮想実行環境とは 37
- 38. • Pythonはオープンソースソフトウェアなので，各パッケー ジも追加機能が次々開発され，バージョンが上がっていく – あるパッケージは他のパッケージの機能を参照したりする（つま り両方のパッケージがインポートされていないと動かない）ため， あるパッケージのバージョンを上げると運が悪い場合他のパッ ケージが動かなくなることがある • 例：「バージョン3.6のPython」に「バージョン1.14.1のnumpy」と「バー ジョン0.22.0のpandas」をインポートした実行環境なら動くよ！ – 言い換えれば「それ以外の実行環境では動かないかもよ！」 • pipでインストールしたパッケージなら実行環境を出力可 – 「pip freeze」でインストール済のパッケージをrequirements.txt というテキストファイルで出力可能 – 別のPC等で実行環境を再現したい場合は，上記のテキスト ファイルをコピーし，「pip install –r requirements.txt」を実行す れば，まとめてインストールできる 仮想実行環境とは 38
- 39. • 必要なパッケージを必要になったタイミングでpipインス トールしているとどんどん増える（気が付けば200パッケージ等） – プロジェクトに必要最小限のパッケージが分からなくなる • 実行環境（Python本体や各パッケージのバージョン）を簡単に 切り替えることができれば，自分の現在の実行環境を壊 すことなく，他者の実行環境をすぐに構築できて便利 • 「仮想環境（virtual environment）」という概念が登場 – 実行環境を「仮想的に」管理・構築 • 例えば，Python本体や各パッケージのインストールをPC本体ではなく ディレクトリ内で完結した形で管理可能 – ディレクトリを変えれば環境が変わるので，同じPCでプロジェクト毎に異なる実行環 境を構築できる – 他のPCに移すときも，ディレクトリごと（あるいはパッケージ管理情報を）渡せばOK – 仮想環境用パッケージ管理ソフトは戦国時代（ありすぎ） • 「conda（Anaconda環境のみ）」，「virtualenv」，「venv」，「pipenv」，… 仮想実行環境とは 39
- 40. • 本資料では恐らく一番スタンダードな「pipenv」による仮 想環境構築を紹介 – pipでPC本体にインストールするのは「pipenv」だけ – 他はpipenvで全てディレクトリ（プロジェクト）毎にインストール • pipenvのインストール – VSCodeを起動 – メニューバーの「ターミナル」 →「新しいターミナル」 – 「pip install pipenv」を入力 し実行 • 色々と文字がでてpipenvが インストールされる • 「pip list」で確認 – pipenv以外にもいくつかの 必要なパッケージが入る pipenvのインストールと初期設定 40
- 41. • pipenvは，デフォルトでは仮想環境ファイル（インストー ルしたパッケージ情報）をユーザーホーム配下に格納 • ディレクトリ（プロジェクト）毎に 仮想環境を作りたい場合は 環境変数を変更する – 「コントロールパネル」 →「システムとセキュリティ」 →「システム」 →左メニューの「システムの 詳細設定」→「環境変数」 pipenvのインストールと初期設定 41
- 42. • ディレクトリ（プロジェクト）毎に仮想環境を作りたい場合 は環境変数を変更する – 「システム環境変数」の欄の「新規」をクリック – 変数名を「PIPENV_VENV_IN_PROJECT」，値を「true」でOK pipenvのインストールと初期設定 42 入力（スペルミスに注意）
- 43. • 念のためVSCodeの仮想環境のディレクトリ設定を確認 – VSCodeのメニューバーの「ファイル」→「基本設定」→「設定」 – 「設定の検索」に「python.venvPath」と入力して出てくる項目が 「.venv」になっていればOK pipenvのインストールと初期設定 43
- 44. • 実際に仮想環境でPythonをインストール・実行してみる – 新規フォルダ「envTest」を作成し，右クリックして「Codeで開く」 – 新規ターミナルを起動し「pipenv --python 3.7」を実行 • 但しシステムに3.7のpythonがインストールされている必要あり pipenvによる仮想環境の構築・実行 44 「.venv」というディレクトリ と「Pipfile」というファイル が自動生成される Pipfileにはインストールし たパッケージとそのバー ジョン一覧が記述され， 「.venv」にはパッケージ本 体がインストールされてい る
- 45. • 実際に仮想環境でPythonをインストール・実行してみる – 「envTest」内でファイル「test.py」を新規作成し，VSCodeで開く – どのPythonを使うか選択のメッセージが表示される pipenvによる仮想環境の構築・実行 45 今はPC本体にイ ンストールされて いるPythonと， ディレクトリ直下 （.venv内）にイン ストールされてい るPythonの2台を VSCodeが認識し ている ここをクリックして 使いたいPython の実行環境を選 択できる
- 46. • 実際に仮想環境でPythonをインストール・実行してみる – 仮想環境（ディレクトリ直下）のインタプリタを選択 • 当然，PC本体にインストールされているPythonを使うこともできる pipenvによる仮想環境の構築・実行 46 仮想環境（.venv） のPythonを選択 これは消す
- 47. • 実際に仮想環境でPythonをインストール・実行してみる – 仮想環境での実行準備が完了 – Hello worldしてみる（F5→エンターで実行） pipenvによる仮想環境の構築・実行 47 仮想環境の Pythonが選択さ れている 仮想環境の Pythonで実行され ている
- 48. • 実際に仮想環境にパッケージを追加してみる – numpyをインストールするには「pipenv install numpy」を実行 • 「pipenv install numpy==1.16」のようにバージョン指定も可能 pipenvによる仮想環境の構築・実行 48 仮想環境に numpyがインス トールされた 「.vscode」という ディレクトリと 「Pipfile.lock」とい うファイルが新規 作成される 「Pipfile」も実は numpyが追記され ている パッケージのバー ジョン管理は 「Pipfile」と 「Pipfile.lock」の2 つで行われる（違 いの説明は割愛）
- 49. • 実際に仮想環境にパッケージを追加してみる – numpyを使うスクリプトを実行 • numpyがインストールされていなければエラーが出るが・・・？ pipenvによる仮想環境の構築・実行 49 numpyを使うスク リプトがエラーなく 実行された （仮想環境にイン ストールされてい るPythonとnumpy が実行された）
- 50. • 実際に仮想環境からパッケージを削除してみる – 「pipenv uninstall numpy」で仮想環境からアンインストール • PipfileやPipfile.lockも書き換わる pipenvによる仮想環境の構築・実行 50 numpyが仮想環 境からアンインス トールされた
- 51. • 実際に仮想環境からパッケージを削除してみる – numpyを使うスクリプトを実行 • numpyがインストールされていなければエラーが出るが・・・？ pipenvによる仮想環境の構築・実行 51 numpyがインス トールされていな いためimportでき ずエラー ここで 実行停止
- 52. • 他環境からの実行環境の再現 – requirements.txtからの環境再現 • プロジェクトディレクトリにrequirements.txtを入れて 「pipenv install –r ./requirements.txt」を実行 – PipfileまたはPipfile.lockからの環境再現 • プロジェクトディレクトリにPipfileを入れて 「pipenv install」または「pipenv install --dev」（開発用パッケージもインストール） • プロジェクトディレクトリにPipfile.lockを入れて 「pipenv sync」または「pipenv sync --dev」 （開発用パッケージもインストール） • 仮想環境にインストールされているパッケージ一覧 – Pipfileをcatやテキストエディタで見る • バージョン指定無しでインストールしたパッケージで，実際にインストー ルされたバージョン等の詳細はPipfile.lockにある pipenvによる仮想環境の構築・実行 52
- 53. • 注意点 – 仮想環境のあるディレクトリ内のPythonファイルを右クリックメ ニューからVSCodeで開くと，仮想環境インタプリタが選べない pipenvによる仮想環境の構築・実行 53 右クリックメニューの 「Codeで開く」でPython ファイルを開くと・・・ ？ なぜか同ディレクトリ内の.venv にある仮想環境のPythonを読 み込まない （表示されているのはPC本体に インストールされているPython）
- 55. • PythonとVSCodeについて • VSCode+Pythonの実行環境の構築方法 – VSCodeのインストールと初期設定 – Pythonのインストールと初期設定 – VSCode+Pythonの環境構築・実行・デバッグ • pipenvによる仮想実行環境の構築方法 – 仮想実行環境とは – pipenvのインストールと初期設定 – pipenvによる仮想環境の構築・実行 • Jupyter notebookの実行環境の構築方法 – Jupyter notebookとは – Jupyter notebookのインストール – Jupyter notebookの実行 目次 55
- 56. • Jupyter notebook（じゅぱいたーのーとぶっく） – ノートブックという形式のファイルにPythonスクリプトを記述 – セル毎の実行やプロット の描画などが可能で 分かりやすい – スクリプトを書いてすぐ に実行し結果を確認可 • 初学者のPython習得や 研究の実験履歴などに 重宝される • コードの共有にも便利 – 昔はiPython notebook という名称だった • ノートブックファイルの 拡張子（.ipynb）にその 名残がある Jupyter notebookとは 56
- 57. • Jupyter notebookのシステム – 純正のJupyter notebookはローカル（又はリモート）サーバを 立ちあげ，ブラウザで接続することでノートブックの編集・実行 等ができる • 2019年10月より，VSCodeのPython拡張機能（p.27でインス トールしたもの）がJupyter notebookをネイティブサポート • 本資料では，pipenvで作成する仮想環境にJupyter notebookをインストールし，ノートブックファイルの作成・ 実行までを解説 Jupyter notebookとは 57
- 58. • 仮想環境でJupyter notebookをインストールしてみる – 新規フォルダ「jupyTest」を作成し，右クリックして「Codeで開く」 – 新規ターミナルを起動し「pipenv --python 3.7」を実行 • 仮想環境にPython 3.7をインストール Jupyter notebookのインストール 58
- 59. • 仮想環境でJupyter notebookをインストールしてみる – 続いてターミナルで「pipenv install jupyter」を実行 • 仮想環境にJupyter notebookをインストール • 必要なパッケージが多くインストールされるので，少し時間がかかる Jupyter notebookのインストール 59
- 60. • 仮想環境でJupyter notebookを実行してみる – Ctrl+Shift+Pを押下し，VSCodeの「コマンドパレット」を表示 – コマンドパレットに「Python: Select」と入力し表示される 「Python: Select Interpreter to start Jupyter server」をクリック Jupyter notebookの実行 60 コマンド パレット
- 61. • 仮想環境でJupyter notebookを実行してみる – jupyTest直下の仮想環境のPythonを選択 • キャッシュに残っている他のディレクトリのPythonも見えることがあるの で注意（パスをよく確認して選択すること） Jupyter notebookの実行 61
- 62. • 仮想環境でJupyter notebookを実行してみる – 画面左下のインタプリタ表示がjupyTestのPythonになればOK • 選択しても左下のインタプリタ表示が「Select Python Interpreter」のま まになる場合は，一度VSCodeを再起動するとうまくいく可能性あり Jupyter notebookの実行 62 仮想環境 のインタ プリタが 認識され ている
- 63. • 仮想環境でJupyter notebookを実行してみる – Ctrl+Shift+Pを押下し，VSCodeの「コマンドパレット」を表示 – コマンドパレットに「Python: Create」と入力し表示される 「Python: Create New Blank Jupyter Notebook」をクリック Jupyter notebookの実行 63
- 64. • 仮想環境でJupyter notebookを実行してみる – 新しいノートブックが作成される – Ctrl+Sで「test.ipynb」という名前を付けて保存 • 拡張子ipynbはJupyter notebookのファイル拡張子 Jupyter notebookの実行 64
- 65. • 仮想環境でJupyter notebookを実行してみる – スクリプトを記述し，Shift+エンターでそのセルを実行 • 実行結果はセルのすぐ下に表示される Jupyter notebookの実行 65 セルを新 しく追加 ここがnot connectedになっていたらJupyter がPythonインタプリタを認識できていない セル （コードの ひとまと まり）
- 66. • 仮想環境でJupyter notebookを実行してみる – Jupyterの変数はセルごとではなく，複数のセルにまたがってい る点に注意 Jupyter notebookの実行 66 変数cは2番目 のセルで定義 されているが， 以降も保存さ れたままなの で4番目のセル で読み出しても 表示される 変数を全てクリアするには，このボタンで Jupyterのカーネルをリセットする必要がある
- 67. • Pythonは簡単な言語だが環境構築が一番大変 • ここで解説した内容も，ソフトウェアが変われば大きく変 わるので注意 – VSCodeのメジャーアップデートなど さいごに 67