如何在CI/CD流水线中无需创建虚拟环境，用uv pip install安装包？

在CI/CD流水线中使用uv包管理器，希望直接使用虚拟机的全局Python解释器（未创建虚拟环境），但运行uv pip install <package>时出现如下错误：

Requirement already satisfied: pip in /opt/hostedtoolcache/Python/3.12.4/x64/lib/python3.12/site-packages (24.1.1)
Collecting pip
  Downloading pip-24.1.2-py3-none-any.whl.metadata (3.6 kB)
Downloading pip-24.1.2-py3-none-any.whl (1.8 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.8/1.8 MB 32.0 MB/s eta 0:00:00
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 24.1.1
    Uninstalling pip-24.1.1:
      Successfully uninstalled pip-24.1.1
Successfully installed pip-24.1.2
Collecting uv
  Downloading uv-0.2.23-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (35 kB)
Downloading uv-0.2.23-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (13.4 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 13.4/13.4 MB 104.1 MB/s eta 0:00:00
Installing collected packages: uv
Successfully installed uv-0.2.23
error: No virtual environment found

解决方案 #

• 直接添加--system参数强制安装到全局环境：

  uv pip install <package> --system
  

  该参数会跳过uv的虚拟环境检查，将包直接安装到当前全局Python的site-packages目录。

• 若CI环境存在多版本Python，可指定全局解释器路径：

  uv pip install <package> --system --python /opt/hostedtoolcache/Python/3.12.4/x64/bin/python3
  

注意事项 #

• 全局安装可能引发依赖冲突，CI场景优先推荐虚拟环境隔离；若必须使用全局环境，--system是uv官方支持的合法方式。
• 确保CI执行用户拥有全局Python目录的写入权限，避免安装时出现权限报错。

内容的提问来源于stack exchange，提问作者Péter Szilvási