uv 工具管理指南uvx 与 uv tool install 实战5 个场景管好 Python 命令行工具【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uvuv 工具管理指南带你用 uvx 运行 Python 命令行工具、用 uv tool install 安装常用工具从 30 秒上手到团队协作、避坑清单一篇讲全。先跑起来30 秒体验 uvx在终端里直接敲这一行uvx pycowsay hello from uvx跑完你会看到一只 ASCII 奶牛把这句话叼在嘴边。它没装进你的任何环境uv 工具管理为每次uvx调用准备一个临时隔离环境装完即走系统里不留痕迹。uvx 还是 uv tool install一句话分工临时用就uvx常驻用就uv tool install。对比项uvxuv tool install定位临时运行跑完即弃常驻安装可执行文件进 PATH装到哪临时隔离环境每个工具一个独立环境能否不带 uv 直接敲命令不能能适用场景偶尔用一次、试新版本每天都要用的工具两者共享同一个缓存所以第一次uvx试过的包之后uv tool install几乎是秒装。三分钟上手安装 uv 并验证没装过 uv 的话一行命令搞定Linux / macOScurl -LsSf https://astral.sh/uv/install.sh | shWindowsPowerShell则是irm https://astral.sh/uv/install.ps1 | iex。装完验证一下uv --version能输出版本号就可以继续了。uvx 实战按场景走uvx 基本运行工具名直接跟参数就行工具名后的所有内容都会原样传给工具本身uvx black --check main.py注意uvx运行的是命令不是包。大多数情况下命令名和包名一致不一致时用--from指定包名例如uvx --from httpie http。uvx 指定版本运行工具后跟版本号精确锁版本范围约束则用--fromuvx ruff0.4.0 checkuvx --from ruff0.3.0,0.5.0 ruff check锁定版本后任何人、任何时间跑同一条命令行为都完全一致。用 --with-requirements 给工具注入依赖有些工具需要额外包配合比如给 mkdocs 装主题插件。--with可以重复--with-requirements可以整份 requirements 文件注入uvx --with-requirements docs/requirements.txt mkdocs serve注入的包和工具同处一个隔离环境互不污染。从 Git 仓库运行想试主干开发版而不是已发布版本用--from git指向仓库可以带分支或 taguvx --from githttps://github.com/astral-sh/blackmain black --help仓库用了 Git LFS 的话再加--lfs。uvx 指定 Python 版本--python决定工具跑在哪个解释器上本机没有对应版本时uv 会自动下载uvx --python 3.11 pycowsay hiuv tool install 实战把工具变成常驻命令uv tool install 基本安装uv tool install ruff装完直接敲ruff --version就能用。注意装进 PATH 的只是可执行文件包本身的模块依然隔离在工具自己的环境里python -c import ruff会失败——这正是防冲突的关键。uv tool install 指定版本安装版本约束直接写进参数约束会被记住uv tool install ruff0.4,0.5之后每次升级都不会跳出这个范围。uv tool install 批量安装一条命令装多个工具适合初始化一台新机器uv tool install ruff black mypyuv tool upgrade 升级工具升级是独立的upgrade子命令别名updateuv tool upgrade ruff升级会遵守安装时的版本约束想突破约束重新执行一次uv tool install并给出新约束即可。全部工具一起升uv tool upgrade --alluv tool uninstall 卸载按包名卸载--all清空所有已装工具uv tool uninstall ruffuv PATH 配置与 UV_TOOL_BIN_DIR装完工具如果提示command not found先查可执行文件目录uv tool dir --bin最快的修复方式是让 uv 自己写 shell 配置uv tool update-shell手动配置的话Linux / macOS 加到~/.bashrc或~/.zshrcexport PATH$HOME/.local/bin:$PATHWindowsPowerShell加到用户环境变量$env:PATH ;$env:LOCALAPPDATA\uv\tools\bin想换默认目录设置UV_TOOL_BIN_DIR指定可执行文件目录、UV_TOOL_DIR指定工具环境目录再重新安装即可。团队协作锁定版本 同步工具清单Makefile 固定工具版本把检查命令锁死在指定版本谁的机器跑make lint结果都一样lint: uvx ruff0.4.0 check .CI 里同样推荐uvx按版本运行不依赖 CI 镜像里预装的东西uvx mypy1.13.0 src/导出/导入工具清单uv tool list --show-version-specifiers会列出每个工具及安装时的版本约束重定向到文件就是团队的工具清单新机器按清单逐个装回去uv tool list --show-version-specifiers tools.txtxargs -L1 uv tool install tools.txt避坑清单症状安装后提示 command not found。解法跑uv tool dir --bin确认目录再执行uv tool update-shell写入 PATH 配置重开终端。症状uvx 报依赖版本冲突。解法给工具本身或冲突的包指定具体版本uvx ruff0.4.0或用--with注入你认可的版本确认是缓存问题就加--refresh强制重新解析。症状Docker 容器里装完工具找不到命令。解法ENV里显式写死工具可执行目录的 PATH别依赖update-shell容器里没有交互式 shell 配置可写。症状指定版本后提示找不到。解法语法只接受精确版本ruff0.4.0范围约束必须走--from ruff0.4另确认版本写的是包名而不是命令名。小结临时用uvx常驻用uv tool install共享缓存所以都快。版本约束写进参数uv 会一直替你守着。PATH 出问题先查uv tool dir --bin再用uv tool update-shell修。现在就去终端敲一条uvx pycowsay 上手成功然后把你最常用的工具装起来。更多工具用法见官方指南 docs/guides/tools.md【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 uv 工具管理指南：uvx 与 uv tool install 实战，5 个场景管好 Python 命令行工具
uv 工具管理指南uvx 与 uv tool install 实战5 个场景管好 Python 命令行工具【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uvuv 工具管理指南带你用 uvx 运行 Python 命令行工具、用 uv tool install 安装常用工具从 30 秒上手到团队协作、避坑清单一篇讲全。先跑起来30 秒体验 uvx在终端里直接敲这一行uvx pycowsay hello from uvx跑完你会看到一只 ASCII 奶牛把这句话叼在嘴边。它没装进你的任何环境uv 工具管理为每次uvx调用准备一个临时隔离环境装完即走系统里不留痕迹。uvx 还是 uv tool install一句话分工临时用就uvx常驻用就uv tool install。对比项uvxuv tool install定位临时运行跑完即弃常驻安装可执行文件进 PATH装到哪临时隔离环境每个工具一个独立环境能否不带 uv 直接敲命令不能能适用场景偶尔用一次、试新版本每天都要用的工具两者共享同一个缓存所以第一次uvx试过的包之后uv tool install几乎是秒装。三分钟上手安装 uv 并验证没装过 uv 的话一行命令搞定Linux / macOScurl -LsSf https://astral.sh/uv/install.sh | shWindowsPowerShell则是irm https://astral.sh/uv/install.ps1 | iex。装完验证一下uv --version能输出版本号就可以继续了。uvx 实战按场景走uvx 基本运行工具名直接跟参数就行工具名后的所有内容都会原样传给工具本身uvx black --check main.py注意uvx运行的是命令不是包。大多数情况下命令名和包名一致不一致时用--from指定包名例如uvx --from httpie http。uvx 指定版本运行工具后跟版本号精确锁版本范围约束则用--fromuvx ruff0.4.0 checkuvx --from ruff0.3.0,0.5.0 ruff check锁定版本后任何人、任何时间跑同一条命令行为都完全一致。用 --with-requirements 给工具注入依赖有些工具需要额外包配合比如给 mkdocs 装主题插件。--with可以重复--with-requirements可以整份 requirements 文件注入uvx --with-requirements docs/requirements.txt mkdocs serve注入的包和工具同处一个隔离环境互不污染。从 Git 仓库运行想试主干开发版而不是已发布版本用--from git指向仓库可以带分支或 taguvx --from githttps://github.com/astral-sh/blackmain black --help仓库用了 Git LFS 的话再加--lfs。uvx 指定 Python 版本--python决定工具跑在哪个解释器上本机没有对应版本时uv 会自动下载uvx --python 3.11 pycowsay hiuv tool install 实战把工具变成常驻命令uv tool install 基本安装uv tool install ruff装完直接敲ruff --version就能用。注意装进 PATH 的只是可执行文件包本身的模块依然隔离在工具自己的环境里python -c import ruff会失败——这正是防冲突的关键。uv tool install 指定版本安装版本约束直接写进参数约束会被记住uv tool install ruff0.4,0.5之后每次升级都不会跳出这个范围。uv tool install 批量安装一条命令装多个工具适合初始化一台新机器uv tool install ruff black mypyuv tool upgrade 升级工具升级是独立的upgrade子命令别名updateuv tool upgrade ruff升级会遵守安装时的版本约束想突破约束重新执行一次uv tool install并给出新约束即可。全部工具一起升uv tool upgrade --alluv tool uninstall 卸载按包名卸载--all清空所有已装工具uv tool uninstall ruffuv PATH 配置与 UV_TOOL_BIN_DIR装完工具如果提示command not found先查可执行文件目录uv tool dir --bin最快的修复方式是让 uv 自己写 shell 配置uv tool update-shell手动配置的话Linux / macOS 加到~/.bashrc或~/.zshrcexport PATH$HOME/.local/bin:$PATHWindowsPowerShell加到用户环境变量$env:PATH ;$env:LOCALAPPDATA\uv\tools\bin想换默认目录设置UV_TOOL_BIN_DIR指定可执行文件目录、UV_TOOL_DIR指定工具环境目录再重新安装即可。团队协作锁定版本 同步工具清单Makefile 固定工具版本把检查命令锁死在指定版本谁的机器跑make lint结果都一样lint: uvx ruff0.4.0 check .CI 里同样推荐uvx按版本运行不依赖 CI 镜像里预装的东西uvx mypy1.13.0 src/导出/导入工具清单uv tool list --show-version-specifiers会列出每个工具及安装时的版本约束重定向到文件就是团队的工具清单新机器按清单逐个装回去uv tool list --show-version-specifiers tools.txtxargs -L1 uv tool install tools.txt避坑清单症状安装后提示 command not found。解法跑uv tool dir --bin确认目录再执行uv tool update-shell写入 PATH 配置重开终端。症状uvx 报依赖版本冲突。解法给工具本身或冲突的包指定具体版本uvx ruff0.4.0或用--with注入你认可的版本确认是缓存问题就加--refresh强制重新解析。症状Docker 容器里装完工具找不到命令。解法ENV里显式写死工具可执行目录的 PATH别依赖update-shell容器里没有交互式 shell 配置可写。症状指定版本后提示找不到。解法语法只接受精确版本ruff0.4.0范围约束必须走--from ruff0.4另确认版本写的是包名而不是命令名。小结临时用uvx常驻用uv tool install共享缓存所以都快。版本约束写进参数uv 会一直替你守着。PATH 出问题先查uv tool dir --bin再用uv tool update-shell修。现在就去终端敲一条uvx pycowsay 上手成功然后把你最常用的工具装起来。更多工具用法见官方指南 docs/guides/tools.md【免费下载链接】uvAn extremely fast Python package and project manager, written in Rust.项目地址: https://gitcode.com/GitHub_Trending/uv/uv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考