FAILED (Ubuntu 20.04 using python-build 20180424)の解決方法【2025年最新版】

エラーの概要・症状

このエラーメッセージは、Ubuntu 20.04環境でPythonをインストールしようとした際に発生するものです。具体的には、 pyenvを利用してPythonをビルドする際に、必要なコンパイルモジュールが不足していることが原因で、ビルドプロセスが失敗しています。エラーメッセージには、fatal error: curses.h: No such file or directoryやModuleNotFoundError: No module named 'zlib'などが含まれています。

このエラーが発生すると、Pythonのインストールに失敗し、プログラムの実行ができなくなるため、開発環境の構築が行えなくなります。特に、Pythonを使用しているプロジェクトやアプリケーションに依存している場合、非常に困った状況になります。

このエラーが発生する原因

このエラーの主な原因は、Pythonのビルドに必要な依存ライブラリがインストールされていないことです。具体的には、以下の主要な依存関係が不足していることがあります。

1. cursesライブラリ: curses.hが見つからないエラーは、端末操作やテキストユーザーインターフェイスを提供するためのライブラリが不足していることを示します。これにより、Pythonの_cursesモジュールがビルドできなくなります。

2. zlibライブラリ: zlibはデータ圧縮に使用されるライブラリであり、Pythonのビルドに必須です。zlibがインストールされていないと、アーカイブや圧縮データを扱うための機能が無効になります。

3. ffi.h: ffi.hはForeign Function Interfaceのヘッダファイルで、Pythonの_ctypesモジュールをビルドするために必要です。

4. その他のライブラリ: libbz2-dev, libreadline-dev, libsqlite3-devなども、Pythonのオプションモジュールをビルドするために必要です。これらのライブラリが不足していると、ビルドが失敗する可能性があります。

これらのライブラリは、Ubuntuのパッケージマネージャを通じて簡単にインストールすることができますが、インストールされていない状態でPythonのビルドを実行すると、このようなエラーが発生します。