diff --git a/docs/reference/build_failures.md b/docs/reference/build_failures.md index 335a42668c01..d9a792284087 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