From d4d6da1558ea53cb337f5a3eae3e5eac75d5b402 Mon Sep 17 00:00:00 2001 From: Zanie Blue Date: Wed, 4 Dec 2024 11:15:24 -0600 Subject: [PATCH] Add `build-essentials` note to build failures doc (#9641) Addresses https://github.com/astral-sh/uv/pull/9584#discussion_r1869950499 --- docs/reference/build_failures.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/reference/build_failures.md b/docs/reference/build_failures.md index 335a42668..d9a792284 100644 --- a/docs/reference/build_failures.md +++ b/docs/reference/build_failures.md @@ -140,14 +140,21 @@ If the build error mentions a missing command, for example, `gcc`: Then, you'll need to install it with your system package manager, e.g., to resolve the error above: ```console -$ apt-get install gcc +$ apt install gcc ``` -!!! note +!!! tip When using the uv-managed Python versions, it's common to need `clang` installed instead of `gcc`. + Many Linux distributions provide a package that includes all the common build dependencies. + You can address most build requirements by installing it, e.g., for Debian or Ubuntu: + + ```console + $ apt install build-essential + ``` + ### Header or library is missing If the build error mentions a missing header or library, e.g., a `.h` file, then you'll need to