Здравствуйте дамы и господа. Прежде хочется написать пару слов о том, что статья рассчитана на решение проблемы, с которой чаще всего сталкиваются новички при сборке библиотек из исходников C++ для питона и решения проблемы подходят для их распространенного случая. Это действительно одна из самых часто проявляемых проблем при установке библиотек и выглядит примерно таким образом:
check.warn(importable)
...
running build_ext
building '***' extension
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for ***
Failed to build ***
ERROR: Could not build wheels for ***, which is required to install pyproject.toml-based projects
Данная ошибка сообщает нам о том, что сборка библиотеки из исходников невозможна по причине отсутствия в вашей системе необходимых средств для сборки. Как видно из описания, требуется пакет инструментов Microsoft Visual C++ 14.0 версии или выше, а также приведена ссылка, по которой можно скачать установщик. Но для начала попробуйте выполнить следующую команду и повторить установку проблемной библиотеки:
pip install --upgrade setuptools
Если ошибка осталась и у вас еще не установлен Visual Studio Build Tools или Visual Studio, загрузите установщик и запустите его. При установке следует выбрать «Разработка классических приложений на C++». В правой колонке будут выбраны пакеты, готовые к загрузке и установке. Как правило, по умолчанию выделен минимально необходимый набор пакетов для большинства задач. Выберите дополнительные пакеты, если они вам нужны и нажмите кнопку «Изменить/Установить». После завершения загрузки и установки пакетов выполните перезаход в систему или перезагрузите компьютер. После чего попробуйте снова установить библиотеку, при попытке сборки которой происходила ошибка.
Если ошибка по-прежнему осталась, скорее всего неверно указан или вовсе отсутствует путь до сборщика в «переменных средах». Кликните ПКМ на кнопке «Пуск» и выберите пункт «Система», а в открывшемся окне «Параметров» нажмите на «Дополнительные параметры системы» и в открывшемся окне «свойства системы» нажмите кнопку «Параметры среды». В окне «Переменные среды пользователя хххх» выберите строку «Path» и нажмите «Изменить». Посмотрите внимательно по списку, нет ли в нем строки, содержащей что-то вроде «C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x64». Это путь при стандартной установке VS. В зависимости от версии установленных VS, пакета MSVC, разрядности сборщика и раздела, который был выбран при установке, в вашем случае путь может отличаться. Если путь к сборщику отсутствует, нажмите кнопку «Создать» и вставьте путь. После этого желательно перезапустить виртуальную среду, в которой вы работаете со своим Python приложением, а в некоторых случаях может потребоваться перезапуск системы.
Если же вы все еще сталкиваетесь с этой ошибкой, то вероятнее всего, ранее у вас уже был установлен Visual Studio другой версии, либо он был неверно сконфигурирован, из-за чего в реестре могли остаться «следы», препятствующие запуску сборщика. Откройте «Редактор реестра» и перейдите в ветку «HKEY_CURRENT_USER\Software\Microsoft\Command Processor\AutoRun». Если она существует, удалите ее (только «AutoRun»). Тоже самое проделайте с веткой «HKEY_LOCAL_MACHINE\Software\Microsoft\Command Processor\AutoRun». Может потребоваться перезаход в систему. Теперь попробуйте выполнить установку проблемной библиотеки.
Эти решения подходят в большинстве аналогичных случаев и проблема фиксится однократно. Но на самом деле данная ошибка может возникать по массе других частных случаев, как например, проблемы совместимости зависимостей библиотеки. Но, как я уже и сказал, это частные случаи. Ну и напишите комментарий, как вы побороли аналогичную ошибку в своем частном случае.