介绍
# UV Global
在 `~/.uv-global` 创建并复用一个全局 `uv` 环境,以便为快速、临时的脚本安装 Python 依赖,而不会污染系统解释器。
闪电般的设置,保持一个共享的虚拟环境随时准备处理临时任务。
当用户需要未预安装的 Python 包(数据处理、爬虫等),而创建完整的项目专用环境又显得大材小用时,请使用此技能。如果用户明确需要系统 Python 或项目本地 venv,则跳过此步骤。
## 要求
`uv` 可用。如果缺失,则需要 `brew` (macOS/Linux) 或 `curl` 来进行安装。
## 安装
```bash bash ${baseDir}/install.sh ```
该脚本将:
- 如果 `uv` 不存在,则通过 `brew` (macOS/Linux) 或官方 `curl` 安装程序安装 `uv` - 在 `~/.uv-global` 创建一个全局 uv 项目 - 在 `~/.uv-global/.venv` 创建一个包含常用包的虚拟环境 - 在 `~/.uv-global/.venv/bin` 中创建一些有用的 shims(垫片)
[可选] 将 venv 的 bin 目录添加到你的 `PATH` 前置,以便 `python` 默认使用全局环境并使 shims 可用:
``` export PATH=~/.uv-global/.venv/bin:$PATH ```
## 用法
对于任何需要额外依赖的快速 Python 脚本:
```bash # install required packages into the global env uv --project ~/.uv-global add <pkg0> <pkg1> ...
# write your code touch script.py
# run your script using the global env uv --project ~/.uv-global run script.py ```
提示: - 脚本可以放在任何位置;`--project ~/.uv-global` 标志确保它们使用全局环境运行。 - 使用 `uv --project ~/.uv-global pip list` 检查已安装的包。 - 如果任务发展成为一个真正的项目,请改用项目本地的 venv,而不是此全局环境。