{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/586", "result": {"data":{"issuesJson":{"id":"0e9557b5-f54f-51a4-81f3-58645f436719","title":"astral-sh/uv: 一个用 Rust 编写的极快的 Python 包和项目管理器。","number":586,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposastral-sh/uv
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

uv

\n

\"uv\"
\n\"image\"
\n\"image\"
\n\"image\"
\n\"Actions
\n\"Discord\"

\n

An extremely fast Python package and project manager, written in Rust.

\n

\n \n \n \n \"Shows\n \n

\n

\n Installing Trio's dependencies with a warm cache.\n

\n

Highlights

\n\n

uv is backed by Astral, the creators of
\nRuff.

\n

Installation

\n

Install uv with our standalone installers:

\n
# On macOS and Linux.\ncurl -LsSf https://astral.sh/uv/install.sh | sh
\n
# On Windows.\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"
\n

Or, from PyPI:

\n
# With pip.\npip install uv
\n
# Or pipx.\npipx install uv
\n

If installed via the standalone installer, uv can update itself to the latest version:

\n
uv self update
\n

See the installation documentation for
\ndetails and alternative installation methods.

\n

Documentation

\n

uv's documentation is available at docs.astral.sh/uv.

\n

Additionally, the command line reference documentation can be viewed with uv help.

\n

Features

\n

Projects

\n

uv manages project dependencies and environments, with support for lockfiles, workspaces, and more,
\nsimilar to rye or poetry:

\n
$ uv init example\nInitialized project `example` at `/home/user/example`\n\n$ cd example\n\n$ uv add ruff\nCreating virtual environment at: .venv\nResolved 2 packages in 170ms\n   Built example @ file:///home/user/example\nPrepared 2 packages in 627ms\nInstalled 2 packages in 1ms\n + example==0.1.0 (from file:///home/user/example)\n + ruff==0.5.0\n\n$ uv run ruff check\nAll checks passed!\n\n$ uv lock\nResolved 2 packages in 0.33ms\n\n$ uv sync\nResolved 2 packages in 0.70ms\nAudited 1 package in 0.02ms
\n

See the project documentation to get started.

\n

uv also supports building and publishing projects, even if they're not managed with uv. See the
\npublish guide to learn more.

\n

Scripts

\n

uv manages dependencies and environments for single-file scripts.

\n

Create a new script and add inline metadata declaring its dependencies:

\n
$ echo 'import requests; print(requests.get(\"https://astral.sh\"))' > example.py\n\n$ uv add --script example.py requests\nUpdated `example.py`
\n

Then, run the script in an isolated virtual environment:

\n
$ uv run example.py\nReading inline script metadata from: example.py\nInstalled 5 packages in 12ms\n<Response [200]>
\n

See the scripts documentation to get started.

\n

Tools

\n

uv executes and installs command-line tools provided by Python packages, similar to pipx.

\n

Run a tool in an ephemeral environment using uvx (an alias for uv tool run):

\n
$ uvx pycowsay 'hello world!'\nResolved 1 package in 167ms\nInstalled 1 package in 9ms\n + pycowsay==0.0.0.2\n  \"\"\"\n\n  ------------\n< hello world! >\n  ------------\n   \\   ^__^\n    \\  (oo)\\_______\n       (__)\\       )\\/\\\n           ||----w |\n           ||     ||
\n

Install a tool with uv tool install:

\n
$ uv tool install ruff\nResolved 1 package in 6ms\nInstalled 1 package in 2ms\n + ruff==0.5.0\nInstalled 1 executable: ruff\n\n$ ruff --version\nruff 0.5.0
\n

See the tools documentation to get started.

\n

Python versions

\n

uv installs Python and allows quickly switching between versions.

\n

Install multiple Python versions:

\n
$ uv python install 3.10 3.11 3.12\nSearching for Python versions matching: Python 3.10\nSearching for Python versions matching: Python 3.11\nSearching for Python versions matching: Python 3.12\nInstalled 3 versions in 3.42s\n + cpython-3.10.14-macos-aarch64-none\n + cpython-3.11.9-macos-aarch64-none\n + cpython-3.12.4-macos-aarch64-none
\n

Download Python versions as needed:

\n
$ uv venv --python 3.12.0\nUsing Python 3.12.0\nCreating virtual environment at: .venv\nActivate with: source .venv/bin/activate\n\n$ uv run --python pypy@3.8 -- python --version\nPython 3.8.16 (a9dbdca6fc3286b0addd2240f11d97d8e8de187a, Dec 29 2022, 11:45:30)\n[PyPy 7.3.11 with GCC Apple LLVM 13.1.6 (clang-1316.0.21.2.5)] on darwin\nType \"help\", \"copyright\", \"credits\" or \"license\" for more information.\n>>>>
\n

Use a specific Python version in the current directory:

\n
$ uv python pin 3.11\nPinned `.python-version` to `3.11`
\n

See the Python installation documentation to get
\nstarted.

\n

The pip interface

\n

uv provides a drop-in replacement for common pip, pip-tools, and virtualenv commands.

\n

uv extends their interfaces with advanced features, such as dependency version overrides,
\nplatform-independent resolutions, reproducible resolutions, alternative resolution strategies, and
\nmore.

\n

Migrate to uv without changing your existing workflows — and experience a 10-100x speedup — with the
\nuv pip interface.

\n

Compile requirements into a platform-independent requirements file:

\n
$ uv pip compile docs/requirements.in \\\n   --universal \\\n   --output-file docs/requirements.txt\nResolved 43 packages in 12ms
\n

Create a virtual environment:

\n
$ uv venv\nUsing Python 3.12.3\nCreating virtual environment at: .venv\nActivate with: source .venv/bin/activate
\n

Install the locked requirements:

\n
$ uv pip sync docs/requirements.txt\nResolved 43 packages in 11ms\nInstalled 43 packages in 208ms\n + babel==2.15.0\n + black==24.4.2\n + certifi==2024.7.4\n ...
\n

See the pip interface documentation to get started.

\n

Platform support

\n

See uv's platform support document.

\n

Versioning policy

\n

See uv's versioning policy document.

\n

Contributing

\n

We are passionate about supporting contributors of all levels of experience and would love to see
\nyou get involved in the project. See the
\ncontributing guide to get started.

\n

Acknowledgements

\n

uv's dependency resolver uses PubGrub under the hood. We're
\ngrateful to the PubGrub maintainers, especially Jacob Finkelman, for
\ntheir support.

\n

uv's Git implementation is based on Cargo.

\n

Some of uv's optimizations are inspired by the great work we've seen in pnpm,
\nOrogene, and Bun. We've also
\nlearned a lot from Nathaniel J. Smith's Posy and adapted its
\ntrampoline
\nfor Windows support.

\n

License

\n

uv is licensed under either of

\n\n

at your option.

\n

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in uv
\nby you, as defined in the Apache-2.0 license, shall be dually licensed as above, without any
\nadditional terms or conditions.

\n
\n \n \"Made\n \n
","updatedAt":"2025-05-22T01:52:06Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Version-Switch-Tools","color":"8ff216"}},{"node":{"name":"astral-sh","color":"64ccda"}}]},"comments":{"edges":[]}}},"pageContext":{"number":586,"previous":{"title":"Safe3/uuWAF: 一款工业级免费、高性能、高扩展，支持AI和语义引擎的Web应用和API安全防护产品。","number":585},"next":{"title":"hashicorp/vault: 一个用于密钥管理、加密服务和访问权限管理的工具","number":587}}}, "staticQueryHashes": ["151096407","2861350382"]}