Python 開発環境

Ubuntu 26.04 には、デフォルトで Python 3.14 が同梱されます (26.04.1 イメージの 3.14.3)。この記事では、マルチバージョンおよび仮想環境管理を備えた完全な Python 開発環境をセットアップする方法について説明します。

システム Python

システムの Python バージョンを確認します。


python3 --version

重要な開発パッケージをインストールします。


sudo apt update
sudo apt install python3-pip python3-venv python3-dev build-essential -y

Warning

Ubuntu 26.04 は PEP 668 に従います。システム Python は「外部管理」としてマークされているため、pip install をシステム環境に直接接続することはできません。これを行うと、externally-managed-environment エラーが発生します。常に仮想環境 (venv/conda) 内にインストールするか、スタンドアロン CLI ツールには pipx を使用してください。

Python 3.14 およびその他のバージョンの使用

デフォルトでは、python3 は Python 3.14 (26.04.1 イメージの 3.14.3) を指します。現在のバージョンを確認します。


python3 --version
# Python 3.14.3

3.13 や 3.12 などの古いバージョンが必要な場合 (たとえば、サードパーティのパッケージがまだ 3.14 をサポートしていないため)、deadsnakes PPA または pyenv を使用してインストールします。 システム python3 を交換しないでください。システムツールが破損する可能性があります。

リポジトリにまだ存在しない古いバージョンまたは新しいバージョンが必要な場合は、deadsnakes PPA を使用します。


sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
 
# For example, install 3.12
sudo apt install python3.12 python3.12-venv -y
python3.12 --version

Note

複数の python3.x バージョンをインストールしても、python3 が指すバージョンは変わりません。グローバル/プロジェクトのバージョンを柔軟に切り替える必要がある場合は、pyenv (以下で説明します) を使用します。

venv を使用して仮想環境を作成する

venv は、Python の組み込み仮想環境ツールであり、プロジェクトレベルの依存関係の分離に推奨されます。


# Create a virtual environment
python3 -m venv myproject-env
 
# Activate the virtual environment
source myproject-env/bin/activate
 
# Your prompt will now show (myproject-env)
# Install dependencies
pip install requests flask
 
# Export dependencies
pip freeze > requirements.txt
 
# Install from a file
pip install -r requirements.txt
 
# Deactivate the virtual environment
deactivate

pip パッケージ管理

基本的な使い方


# Install a package
pip install package-name
 
# Install a specific version
pip install package-name==1.2.3
 
# Upgrade a package
pip install --upgrade package-name
 
# Uninstall a package
pip uninstall package-name
 
# List installed packages
pip list
 
# Find outdated packages
pip list --outdated

中国ミラーソースの構成

中国本土で pip を使用する場合、ダウンロードを高速化するためにミラーソースを構成することをお勧めします。


pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

または、~/.pip/pip.conf を手動で作成します。


[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

一般的なミラーソース:

清華: https://pypi.tuna.tsinghua.edu.cn/simple
アリユン: https://mirrors.aliyun.com/pypi/simple/
USTC: https://pypi.mirrors.ustc.edu.cn/simple/

pyenv マルチバージョン管理

pyenv を使用すると、同じマシン上に複数の Python バージョンをインストールして切り替えることができます。

依存関係のインストール


sudo apt install -y make build-essential libssl-dev zlib1g-dev \
  libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
  libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
  libffi-dev liblzma-dev

pyenvをインストールする


curl https://pyenv.run | bash

~/.bashrc (または ~/.zshrc) の末尾に次の行を追加します。


export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

構成を適用します。


source ~/.bashrc

pyenvの使用


# List installable versions
pyenv install --list | grep "^  3\."
 
# Install a specific version
pyenv install 3.13
pyenv install 3.14
 
# Set the global version (3.14 recommended)
pyenv global 3.14
 
# Set a local version for a project
cd /path/to/project
pyenv local 3.14
 
# List installed versions
pyenv versions

コンダ/ミニコンダ

Conda は、データサイエンスで広く使用されているクロスプラットフォームパッケージおよび環境管理ツールです。

Minicondaをインストールする


mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm ~/miniconda3/miniconda.sh

シェルを初期化します。


~/miniconda3/bin/conda init bash
source ~/.bashrc

中国ミラーの構成


conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --set show_channel_urls yes

Conda の使用


# Create an environment
conda create -n myenv python=3.14
 
# Activate the environment
conda activate myenv
 
# Install packages
conda install numpy pandas matplotlib
 
# Export an environment
conda env export > environment.yml
 
# Create an environment from file
conda env create -f environment.yml
 
# List all environments
conda env list
 
# Remove an environment
conda env remove -n myenv
 
# Deactivate
conda deactivate

uv: 次世代パッケージマネージャー

uv は、Rust で書かれた超高速の Python パッケージマネージャーで、pip と互換性があります。


# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
 
# Use uv as a pip replacement
uv pip install requests
uv pip install -r requirements.txt
 
# Create a virtual environment
uv venv myenv
source myenv/bin/activate
 
# Manage projects with uv
uv init myproject
cd myproject
uv add flask sqlalchemy
uv run python app.py

推奨されるプロジェクト構造


myproject/
├── pyproject.toml        # Project configuration (recommended)
├── requirements.txt      # Dependency list
├── src/
│   └── myproject/
│       ├── __init__.py
│       └── main.py
├── tests/
│   └── test_main.py
├── .gitignore
└── README.md