uvx/uv 工具包安装方法

Windows 系统

1. 推荐使用 pip 安装 uv（可用清华源加速）

   • 打开命令提示符（Win+R 输入 cmd 回车）
   • 推荐使用清华源加速安装：

     pip install -i https://pypi.tuna.tsinghua.edu.cn/simple uv

   • 如遇权限问题，可用管理员身份运行命令提示符，或加上 --user 参数：

     pip install --user -i https://pypi.tuna.tsinghua.edu.cn/simple uv

2. 检查 uv 是否可用

   • 输入：

     uv --version

   • 若能显示版本号，说明安装成功

3. 如提示找不到 uv 命令

   • 可能是 Python 的 Scripts 目录未加入 PATH
   • 找到 Python 安装目录下的 Scripts 文件夹（如 C:\Users\你的用户名\AppData\Roaming\Python\Python3x\Scripts）
   • 将该路径添加到“系统环境变量”或“用户环境变量”的 PATH 中
   • 重新打开命令行窗口再试

4. 注意事项

   • 不建议使用 Microsoft Store 版 Python，推荐官网下载并安装（见Python 安装方法）

Mac 系统

1. 配置清华源（可选，加速下载）

   pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple uvloop

2. 安装 uv

   pip3 install --cert /etc/ssl/cert.pem uv

3. 检查 uv 是否在 PATH 中

   uv --version

   • 若能显示版本号，说明安装成功
   • 若提示找不到命令，可参考下方“让 uv 全局可用”

4. 让 uv 全局可用（如有需要）

   • 找到 uv 的安装路径：

     python3 -m pip show uv | grep Location

   • 将对应 bin 目录加入 PATH，例如：

     echo 'export PATH="/Users/你的用户名/Library/Python/3.11/bin:$PATH"' >> ~/.zshrc
     source ~/.zshrc

5. 重新打开终端窗口，验证 uv

   uv --version

---

注意：安装或修改 uv/uvx 后，请务必重启 swiflow 应用，以确保新环境被正确识别。