如何使用uvx锁定工具依赖版本，防止自动更新引发问题？

问题核心 #

你遇到的问题是：使用uvx --python=3.10 --from="jupyterlab@4.0.10" jupyter-lab这类命令指定工具版本后，uvx的缓存会在未主动触发的情况下自动刷新，导致后续调用时重新安装工具而非复用已有环境；而uvx本身没有类似项目/脚本功能的lock命令或--frozen/--locked参数来锁定依赖版本。

可行替代方案 #

目前uvx暂未提供原生的版本锁定机制，但可以通过以下几种方式实现等效效果：

1. 固定精确版本+自定义缓存目录 #

每次调用uvx时明确指定工具的精确版本号（如你已使用的jupyterlab@4.0.10），同时通过环境变量指定固定的本地缓存目录，避免系统级缓存被自动刷新：

# 设置专属缓存目录，避免全局缓存变动影响
export UV_CACHE_DIR="./.local-uv-tool-cache"
# 调用uvx时保持精确版本指定
uvx --python=3.10 --from="jupyterlab@4.0.10" jupyter-lab

只要该缓存目录不被删除或手动清理，后续调用会一直复用其中的已安装版本。

2. 将工具安装到项目虚拟环境 #

放弃uvx的临时缓存机制，把工具安装到项目专属虚拟环境中，通过虚拟环境锁定版本：

# 创建指定Python版本的虚拟环境
uv venv --python=3.10
# 激活虚拟环境（Linux/macOS）
source .venv/bin/activate
# Windows PowerShell：.venv\Scripts\Activate.ps1
# 安装指定版本的工具到虚拟环境
uv pip install jupyterlab==4.0.10
# 直接调用工具，此时使用的是虚拟环境内的固定版本
jupyter-lab

这种方式可以配合项目的pyproject.toml或requirements.txt，用uv lock命令彻底锁定所有依赖版本，完全避免自动更新风险。

3. 用uv脚本功能替代uvx #

利用uv的项目脚本功能，借助其原生的锁定机制实现工具调用：

1. 在项目的pyproject.toml中添加脚本配置：

[tool.uv.scripts]
jupyter-lab = { command = "jupyter-lab", package = "jupyterlab==4.0.10", python = "3.10" }

2. 生成依赖锁定文件：

uv lock

3. 调用脚本时添加--locked参数确保不更新依赖：

uv run --locked jupyter-lab

这种方式既保留了类似uvx的便捷调用体验，又能通过项目级锁定机制固定版本。

官方进展说明 #

你提到的issue #5815、#10082确实涉及uvx的缓存与版本锁定讨论，但目前官方尚未推出针对uvx的原生锁定参数。若需要官方支持，可关注这些issue的更新，或向uv仓库提交功能请求。

内容的提问来源于stack exchange，提问作者Nickolay