← 返回命令列表

Linux command

uv-run 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Run command in project

uv run [command]

Run Python script

uv run python [script.py]

Run with extra dependencies

uv run --with [package] [command]

Run a standalone script with inline dependencies

uv run [script.py]

Run without syncing the environment

uv run --frozen [command]

Run with a specific Python version

uv run --python [3.12] python [script.py]

Run an installed tool

uv run pytest [tests/]

说明

uv run executes commands in the project's virtual environment. It automatically creates the virtual environment and syncs dependencies if needed, making it the primary way to run scripts and tools in uv-managed projects. When running a `.py` file with inline script metadata (PEP 723), uv automatically resolves and installs the declared dependencies. The --with flag allows adding ad-hoc dependencies without modifying project configuration.

参数

--with _package_
Include an extra dependency for this invocation only.
--frozen
Run without updating the lockfile. Fail if lockfile is missing or outdated.
--no-sync
Skip syncing the environment before running.
--isolated
Run in an isolated temporary environment, ignoring the project.
--python _version_
Use a specific Python version or interpreter.
--no-project
Avoid discovering a project or workspace.
--package _name_
Run the command in a specific package within a workspace.
--extra _name_
Include optional dependency group.
--all-extras
Include all optional dependency groups.

FAQ

What is the uv-run command used for?

uv run executes commands in the project's virtual environment. It automatically creates the virtual environment and syncs dependencies if needed, making it the primary way to run scripts and tools in uv-managed projects. When running a `.py` file with inline script metadata (PEP 723), uv automatically resolves and installs the declared dependencies. The --with flag allows adding ad-hoc dependencies without modifying project configuration.

How do I run a basic uv-run example?

Run `uv run [command]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --with _package_ do in uv-run?

Include an extra dependency for this invocation only.