Python Jupyter lab のインストールで躓いた

目的：Jupyter labのインストール

現象：

Jupyter labをpipでインストールし、コマンドプロンプトでjupyterlabを実行すると、以下のエラーが出た！

コマンドプロンプト

C:\Users\<username>>jupyter lab
'jupyter lab' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。

原因

• 直接の原因は、pipでjupyterlabをインストールする際、Pythonの意図しないバージョンに紐づいてインストールされてしまった。
  ⇒ [pip install jupyter lab] or [python -m pip install jupyter lab] のどっちなの？問題

• 副次的な要因として、Pythonやpipのバージョン違いがあちこちに保存されており、PATH設定が汚れていた。
  ⇒コマンドプロンプトでPythonを実行したとき、どのバージョンのPythonが実行されたか分からない問題に直面した。

環境：

• windows10 64 bit
• Python38
• jupyter lab 2.2.6

補足：

• これまでPythonのインストールをする際に、バージョン管理せず、適当なフォルダに保存していたため、どこに何があるか分からなくなった。
• そのため、PATHが汚れたり、PIPがあちこちに点在することでどのPIPを実行しているか(PIPでインストールしたパッケージの保存先が分からない)という状況に陥った。

インストール方法：

これらの原因の解決策として、以下の手順でjupyter labのインストールを行った。

1) 元のPython環境を削除

下記サイトを参考にさせていただき、作業を行った。
https://gammasoft.jp/support/uninstall-python-completely-on-windows/

本作業のフローと各作業での補足を以下に記す。

1. ソフトのアンインストール
   補足は特になし

2. 残ったフォルダを手動削除
   注意) 幾つものバージョン違いのPythonをあちこちに保存している場合は、以下のキーワードをファイルエクスプローラーで検索し、見つかったフォルダを手動で(親子皆諸共に！)削除する。
   検索ワード：　python, pip

3. 環境変数の削除
   以下のサイトを参考に環境変数を削除した。
   ★★注意★★) 何度もPythonをインストールするうちに、環境変数の設定が汚れてしまい、掃除に苦労した。確実に消すためには、ユーザ環境変数とシステム環境変数の両方を削除すること。また、設定内容を確実に更新するためには、PCを再起動すること。
   設定変数の更新を確認するには、システムプロパティを見るよりも、コマンドプロンプトでPATH　と入力する方が確実です。

環境変数の削除方法：　ttps://www.javadrive.jp/python/install/index3.html

2) インストール

1. 元の環境を削除　が完了したら、下記のインストール作業を実施する。

• Python インストール
  以下のサイトに従ってインストールする。
  Pythonインストール：　https://www.javadrive.jp/python/install/index1.html
  このとき、「Add To Python PATH」にチェックを入れることで、環境変数の設定を自動で行ってくれる。
  また、Pythonのインストール先は階層が浅い場所に保存するのが、個人的にお勧め。

• pip アップグレード

  • pipはPythonインストール時に一緒にインストールされるはず。
  • 保存先はPythonフォルダ直下のScriptsフォルダの中
  • コマンドプロンプト上で以下のコマンドによりアップグレード

プロンプト

# 通常
pip install pip --upgrade

# pipが複数存在し、どのpipが呼び出されているか分からない場合
python -m pip install --upgrade pip

# 実行したいpipの場所を明示して実行したい場合
cd <pip保存先フォルダのフルパス> -> pip install pip -upgrade  

※2つ目のコマンドは、パスが通っているpython直下のpipが実行される。
※3つ目のコマンドは、pipの保存先を明示して実行するので、一番確実。

• jupyter lab インストール
  下記サイトを参考に実行した。上記の手順が行えていれば、驚くほど簡単にインストールが終わった。

jupyter lab インストール方法の解説ページへ
https://qiita.com/kirikei/items/a1639954ce5ccaf7ac3c

3) まとめ

• Jupyter labをインストールして実行したところ、jupyter が見つからない的なエラーが生じた。
• 過去のPythonを削除するところから始めたらドツボにはぱった。
• その原因は、Python pip が複数存在しており、ちゃんと削除できていなかった。
• PATH設定の更新がうまくできなかった。
• pipが複数存在する状態でpipを実行したところ、予期せぬpipが実行されてしまった。
• 結果的に、不要なファイルの削除と、PATHの設定を正しく行う、pipでインストールされたパッケージの保存先を理解する、この3点を抑えれば、うまくjupyter labがインストールできた。