Use XDG (i.e. ~/.local/bin) instead of the Cargo home directory in the installer (#8420)

Reviving #2236

Basically implements axodotdev/cargo-dist#287

Author: zanieb

Cargo.toml

@@ -335,4 +335,4 @@ github-custom-job-permissions = { "build-docker" = { packages = "write", content
 # Whether to install an updater program
 install-updater = false
 # Path that installers should place binaries in
-install-path = "CARGO_HOME"
+install-path = ["$XDG_BIN_HOME/", "$XDG_DATA_HOME/../bin", "~/.local/bin"]

docs/configuration/installer.md

@@ -2,8 +2,11 @@
 
 ## Changing the install path
 
-By default, uv is installed to `~/.cargo/bin`. To change the installation path, use
-`UV_INSTALL_DIR`:
+By default, uv is installed to `~/.local/bin`. If `XDG_BIN_HOME` is set, it will be used instead.
+Similarly, if `XDG_DATA_HOME` is set, the target directory will be inferred as
+`XDG_DATA_HOME/../bin`.
+
+To change the installation path, use `UV_INSTALL_DIR`:
 
 === "macOS and Linux"
 

docs/getting-started/installation.md

@@ -185,14 +185,14 @@ If you need to remove uv from your system, just remove the `uv` and `uvx` binari
 === "macOS and Linux"
 
     ```console
-    $ rm ~/.cargo/bin/uv ~/.cargo/bin/uvx
+    $ rm ~/.local/bin/uv ~/.local/bin/uvx
     ```
 
 === "Windows"
 
     ```powershell
-    $ rm $HOME\.cargo\bin\uv.exe
-    $ rm $HOME\.cargo\bin\uvx.exe
+    $ rm $HOME\.local\bin\uv.exe
+    $ rm $HOME\.local\bin\uvx.exe
     ```
 
 !!! tip