https://codeweng.com/ Recent content on CodeWeng Blog Hugo -- gohugo.io en-us Tue, 07 Apr 2026 13:01:10 +0800 https://codeweng.com/posts/python-dependencies-the-road-to-uv/ Tue, 07 Apr 2026 13:01:10 +0800 https://codeweng.com/posts/python-dependencies-the-road-to-uv/ <h2 id="背景">背景</h2> <p>我有 C、.NET、Java 的开发背景，Python 语法基本属于看一眼就能上手的类型，但一直没有系统了解过。对 Python 的开发环境，之前的认知仅限于：venv 管虚拟环境、pip 装包、requirements.txt 管依赖。</p> <p>最近在读 Microsoft Agent Framework 的源码，发现它用 uv 和 poe 构建，于是决定顺着这条线把 Python 的依赖管理好好梳理一遍，顺便把笔记整理出来，分享给大家。</p> <hr> <h2 id="uv-是什么">UV 是什么？</h2> <p>简单粗暴地理解：<strong>uv 就是一个用 Rust 重写的、快得离谱的pip + pip-tools + pyenv 的集合体。</strong> 它整合了以下这些工具的功能：</p> <ul> <li><strong>pip / pip-tools</strong>：包安装与依赖解析</li> <li><strong>virtualenv / venv</strong>：虚拟环境管理</li> <li><strong>pipx</strong>：全局安装 CLI 工具</li> <li><strong>poetry</strong>：项目依赖与打包管理</li> <li><strong>twine</strong>：包发布</li> </ul> <p>不过要真正理解 uv 好在哪里，得先把它所取代的这些工具各自过一遍，知道它们解决了什么问题、又留下了什么麻烦。</p> <hr> <h2 id="关于-pip">关于 pip</h2> <p>pip 是 Python 最基础的包管理工具，常用操作就这几条：</p> <ul> <li> <p><strong>安装包：</strong> <code>pip install &lt;包名&gt;</code></p> </li> <li> <p><strong>通过文件批量安装：</strong> <code>pip install -r requirements.txt</code></p> <blockquote> <p>这是项目部署的标准做法，会自动安装文本文件中列出的所有库。</p></blockquote> </li> <li> <p><strong>生成依赖清单：</strong> <code>pip freeze &gt; requirements.txt</code></p> <blockquote> <p>它会扫描当前环境所有已安装的包，按 <code>包名==版本号</code> 的格式写入文件。</p>