【要約】macOSにPython3をインストールする [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
macOS 10.15.4のユーザーが、Python 3環境を構築しようとした。その際、複数の環境依存エラーに直面した。
- ・Apple Command Line Toolsが未インストールであることによる、インストールプロセスの停止。
- ・
/usr/local/Frameworksディレクトリの権限不足に起因する、brew linkステップでのエラー。 - ・パッケージ自体はビルド済みだが、システムへのシンボリックリンクが作成されない問題。
// Approach
開発者は、エラーメッセージの指示に従い、段階的な解決を図った。依存ツールの導入とディレクトリ権限の修正を行った。
- ・
xcode-select --installを実行し、不足していたApple Command Line Toolsを導入。 - ・
sudo mkdir /usr/local/Frameworksおよびsudo chown $(whoami):admin /usr/local/Frameworksを用い、ディレクトリの所有権をユーザーへ変更。 - ・
brew link [email protected]を実行し、インストール済みパッケージのシンボリックリンクを正常に作成。
// Result
適切な権限設定とリンク操作により、Python 3.9.1 の正常な動作を確認した。
- ・
python3.9 -Vコマンドにより、バージョン 3.9.1 が正しく返されることを確認。 - ・対話型シェルにて、
print('Hello World.')が正常に実行されることを確認。 - ・結果として、macOS環境においてPython 3を用いた開発が可能な状態となった。
Senior Engineer Insight
> 本手法は、個人のローカル環境におけるトラブルシューティングとしては有効だ。しかし、実務レベルでは以下の点に注意が必要である。
- ・
sudoによる/usr/local以下の権限変更は、他ツールとの競合を招くリスクがある。 - ・開発環境の再現性を重視する現場では、
pyenvやDockerを用いた環境分離が標準である。 - ・OS標準のPythonを直接操作せず、バージョン管理ツールを介して環境を構築すべきである。