UV 全局

创建并复用全局uv环境于~/.uv-global以便安装 Python 依赖项，用于快速、临时的脚本，而不会污染系统解释器。

闪电般快速的设置，保持一个共享的虚拟环境随时准备处理临时任务。

当用户需要未预安装的 Python 包（数据处理、爬虫等）且创建完整的项目特定环境显得大材小用时，使用此技能。如果用户明确希望使用系统 Python 或项目本地 venv，则跳过此步骤。

要求

uv可用。如果缺失，您需要brew（macOS/Linux）或curl来安装它。

安装

bash ${baseDir}/install.sh

脚本将：

• 通过brew安装uv(macOS/Linux) 或官方curl安装器如果uv不存在
• 在~/.uv-global
• 创建全局 uv 项目在
• ~/.uv-global/.venv创建包含常用包的虚拟环境

在~/.uv-global/.venv/bin创建一些实用的 shim 文件[可选]将虚拟环境的 bin 目录前置到你的PATH

export PATH=~/.uv-global/.venv/bin:$PATH

这样

python

# 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

默认使用全局环境且 shim 文件可用：

• 用法适用于任何需要额外依赖的快速 Python 脚本：提示：
• 脚本可存放在任意位置；uv --project ~/.uv-global pip list.
• 如果任务发展成一个真正的项目，请切换到项目本地的虚拟环境，而不是使用这个全局环境。