快捷導(dǎo)航

Python?UV安裝、升級(jí)、卸載詳細(xì)步驟記錄

更新時(shí)間：2025年06月14日 08:32:20 作者：云客Coder

這篇文章主要介紹了Python?UV安裝、升級(jí)、卸載的詳細(xì)步驟,uv是 Astral推出的下一代 Python 包與項(xiàng)目管理器,主打單一可執(zhí)行文件、極致性能,文中通過(guò)代碼介紹的非常詳細(xì),需要的朋友可以參考下

安裝

pip install uv

檢查

安裝后可運(yùn)行下面命令，查看是否安裝成功

uv --version

% uv --version
uv 0.6.3 (a0b9f22a2 2025-02-24)

升級(jí)

uv self update

將重新運(yùn)行安裝程序并可能修改您的shell配置文件。

要禁用此行為，設(shè)置INSTALLER_NO_MODIFY_PATH=1。

或：

pip install --upgrade uv

設(shè)置自動(dòng)補(bǔ)全

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc

卸載

執(zhí)行以下兩步：

1、清理存儲(chǔ)數(shù)據(jù)（可選）：

$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"

提示：在刪除二進(jìn)制文件之前，您可能想刪除 uv 存儲(chǔ)的任何數(shù)據(jù)。

2、刪除 uv 和 uvx 二進(jìn)制文件：

macOS 和 Linux

$ rm ~/.local/bin/uv ~/.local/bin/uvx

Windows

$ rm $HOME.local\bin\uv.exe
$ rm $HOME.local\bin\uvx.exe

注意：在0.5.0之前，uv被安裝到了~/.cargo/bin?？梢詮哪抢飫h除這些二進(jìn)制文件。
uninstall. 升級(jí)到舊版本將不會(huì)自動(dòng)刪除二進(jìn)制文件 ~/.cargo/bin.

UV 命令

 % uv
An extremely fast Python package manager.

Usage: uv [OPTIONS] <COMMAND>

Commands:
  run      Run a command or script
  init     Create a new project
  add      Add dependencies to the project
  remove   Remove dependencies from the project
  sync     Update the project's environment
  lock     Update the project's lockfile
  export   Export the project's lockfile to an alternate format
  tree     Display the project's dependency tree
  tool     Run and install commands provided by Python packages
  python   Manage Python versions and installations
  pip      Manage Python packages with a pip-compatible interface
  venv     Create a virtual environment
  build    Build Python packages into source distributions and wheels
  publish  Upload distributions to an index
  cache    Manage uv's cache
  self     Manage the uv executable
  version  Display uv's version
  help     Display documentation for a command

Cache options:
  -n, --no-cache               Avoid reading from or writing to the cache,
                               instead using a temporary directory for the
                               duration of the operation [env: UV_NO_CACHE=]
      --cache-dir <CACHE_DIR>  Path to the cache directory [env: UV_CACHE_DIR=]

Python options:
      --python-preference <PYTHON_PREFERENCE>
          Whether to prefer uv-managed or system Python installations [env:
          UV_PYTHON_PREFERENCE=] [possible values: only-managed, managed,
          system, only-system]
      --no-python-downloads
          Disable automatic downloads of Python. [env:
          "UV_PYTHON_DOWNLOADS=never"]

Global options:
  -q, --quiet
          Do not print any output
  -v, --verbose...
          Use verbose output
      --color <COLOR_CHOICE>
          Control the use of color in output [possible values: auto, always,
          never]
      --native-tls
          Whether to load TLS certificates from the platform's native
          certificate store [env: UV_NATIVE_TLS=]
      --offline
          Disable network access [env: UV_OFFLINE=]
      --allow-insecure-host <ALLOW_INSECURE_HOST>
          Allow insecure connections to a host [env: UV_INSECURE_HOST=]
      --no-progress
          Hide all progress outputs [env: UV_NO_PROGRESS=]
      --directory <DIRECTORY>
          Change to the given directory prior to running the command
      --project <PROJECT>
          Run the command within the given project directory
      --config-file <CONFIG_FILE>
          The path to a `uv.toml` file to use for configuration [env:
          UV_CONFIG_FILE=]
      --no-config
          Avoid discovering configuration files (`pyproject.toml`, `uv.toml`)
          [env: UV_NO_CONFIG=]
  -h, --help
          Display the concise help for this command
  -V, --version
          Display the uv version

Use `uv help` for more details.