1. 本质定位差异

• uv → 由 Astral（原 Ruff 团队）开发的超高速 Python 包管理 + 虚拟环境管理工具，定位是替代 pip + venv + pip-tools + poetry 的依赖管理部分。

• poetry → Python 生态内主流的项目依赖管理 + 构建发布工具，偏全能型，但速度一般。

• conda → 跨语言包管理器（Python、C/C++ 库等都能管），带自己的二进制包渠道（conda-forge、Anaconda），主要优势是科学计算依赖的二进制分发。

2. uv 相比 poetry / conda 的主要优势

(1) 极快的速度

• 核心是 Rust 实现 + 并行下载 + 本地缓存，冷装比 pip/poetry 快数倍，热装基本秒级。

• 官方实测：安装 100 个依赖的项目，uv 比 poetry 快 810 倍，比 conda 快 1520 倍。

第一性原理：速度取决于 IO 并发能力 + 解析算法效率。pip/poetry 都是 Python 实现，单线程解析，uv 用 Rust 并发解析 + 请求，效率差距天然存在。

(2) 与 pip 完全兼容

• poetry 有自己的依赖解析器和 lock 格式，和 pip 不是完全兼容；conda 更是独立体系。

• uv 支持直接读写 pyproject.toml、requirements.txt，无额外格式锁定，方便和现有 pip 流程混用。

• 可以用 uv pip install 无缝替代 pip，但享受 uv 的速度和缓存。

(3) 内置跨项目共享缓存

• 安装的 wheel/sdist 缓存是全局的，不同项目重复依赖无需重新下载/构建。

• poetry 的缓存范围较小，conda 虽然有缓存，但 channel 更新时会触发大量重新下载。

(4) 单文件可执行，零环境依赖

• uv 是单独的二进制文件（类似 ripgrep、fd），直接下载运行，不依赖 Python 预安装。

• poetry 自身需要 Python 运行环境，conda 则要安装 Anaconda/Miniconda 体积很大。

(5) 高效锁定与解析

• uv 的解析器（基于 Rust）能在毫秒级完成依赖树解析并生成 uv.lock。

• poetry 的解析是 Python 实现，对复杂依赖树（尤其是冲突检查）会慢很多。

• conda 解析复杂环境时（尤其混合 python+非python包）非常慢。

(6) 轻量化 & 单一职责

• uv 目标是“快速安装、解析、锁定、运行”，构建/发布功能交给成熟工具（如 hatch、setuptools）。

• poetry 集成了构建/发布，功能多但容易卡在某个子模块更新慢的问题。

• conda 则功能更多，但在纯 Python 项目中显得过重。

3. 对比表

4. 关键洞见

1. uv 是 Python 依赖管理的“加速器”，不是全能替代品，如果你的项目还需要构建/发布，可能需要配合 hatch、setuptools 等。

2. conda 的核心价值是非 Python 库的二进制分发，在纯 Python 场景反而累赘。

3. poetry 在“开发体验一体化”上依然有价值，比如版本管理、发布流程集成，但速度被 uv 完爆。

4. uv 现在正处于功能扩展期，未来可能接近 poetry 的一体化，但现在更适合“高性能依赖安装/解析”任务。

5. 常用命令大全

# 创建虚拟环境
uv venv --python=3.12
uv venv --python=3.10

# 激活虚拟环境
# For macOS/Linux
source .venv/bin/activate
# For Windows
.venv\Scripts\activate

# 离开虚拟环境
deactivate

# 虚拟环境安装包，但不会写入到工程依赖中【不推荐】
uv pip install xxx

# 用uv init来完整地管理它的相关环境依赖，项目相关的依赖都会明明白白地写在项目的配置文件中，后面在不同的机器上也能够很快地搭建起这个环境。
uv init .

# uv add等同于uv pip install，且会写入到工程依赖中
uv add xxx

# uv remove等同于 uv pip uninstall，且会将xxx包从工程依赖中移除
uv remove xxx

# 查看工程依赖包的树状结构
uv tree

# 同步锁定依赖（高级用法）根据 requirements.txt 或 requirements.lock 精确安装依赖，保持团队环境一致
uv sync

6. 注意事项

(1) 在项目中更新依赖包并同步更新uv.lock/pyproject.toml

在使用 uv 管理 Python 项目依赖时，如果要引入或更新一个包，并保证 uv.lock 与 pyproject.toml 同步更新，可以按以下两种情况处理：

不知道目标包的具体版本号

以 langgraph 为例，有两种方法：

方法一（推荐）

直接移除再添加，让 uv 自动解析最新版本并写入配置：

uv remove langgraph
uv add langgraph

方法二（不推荐）

利用 uv lock –upgrade-package 升级锁文件：

uv lock --upgrade-package langgraph
uv sync

缺点：此方法只会更新 uv.lock，不会同步更新 pyproject.toml，容易导致配置不一致。

已知目标包的具体版本号

显式指定版本更新：

uv add langgraph==0.6.2

这样会同时更新 pyproject.toml 和 uv.lock，保证依赖版本锁定一致。

💡 小贴士

• uv add 会自动处理安装、依赖解析和配置文件更新，是 uv 最推荐的依赖变更方式。

• 避免手动改 pyproject.toml 再运行 uv lock，因为容易遗漏同步步骤。

• 如果想一次升级多个包，可用：

uv remove 包1 包2 && uv add 包1 包2

1. macOS安装Hugo

brew install hugo

验证安装

hugo version

实际安装版本：hugo v0.148.2

2. 创建Hugo博客项目

hugo new site mackyan --format yaml
cd mackyan

3. 添加主题

选择主题：以PaperMod为例

git init
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

如果是 clone 了其他人的博客项目进行修改，则需要用以下命令进行初始化：

git submodule update --init --recursive

如果需要同步主题仓库的最新修改，需要运行以下命令：

git submodule update --remote

4. 设置主题

vim hugo.yaml

添加内容

theme: PaperMod

5. 写第一篇文章

hugo new posts/first.md

vim content/posts/first.md

新建的文章位于content/posts目录下，编辑内容如下：

---
title: "First Blog Post"
date: 2025-08-03
draft: false
---

欢迎来到我的 Hugo 博客！

6. 本地预览博客

hugo server -D

打开浏览器访问：http://localhost:1313

7. 配置博客信息（可选）

修改hugo.yaml中加入更多信息：

baseURL: "https://mackyan.github.io/"
languageCode: zh-cn
title: Mack Yan
theme: PaperMod

enableEmoji: true

pagination:
  disableAliases: false
  pagerSize: 10

params:
  author: Mack
  ShowToc: true
  ShowReadingTime: true
  ShowPostNavLinks: true

使用Github Actions自动部署

详细配置步骤参考资料2和资料4。

目前有两个仓库：

• mackyan（private）：hugo博客的根目录
• mackyan.github.io（public）：存放hugo生成的静态文件，即mackyan/public目录

在mackyan根目录下建立.github/workflows/hugo.yml文件，配置如下内容：

name: deploy

on:
    push:
    workflow_dispatch:
    schedule:
        # Runs everyday at 8:00 AM
        - cron: "0 0 * * *"

jobs:
    build:
        runs-on: ubuntu-latest
        steps:
            - name: Checkout
              uses: actions/checkout@v2
              with:
                  submodules: true
                  fetch-depth: 0

            - name: Setup Hugo
              uses: peaceiris/actions-hugo@v2
              with:
                  hugo-version: "latest"

            - name: Build Web
              run: hugo

            - name: Deploy Web
              uses: peaceiris/actions-gh-pages@v3
              with:
                  PERSONAL_TOKEN: ${{ secrets.GH_PAGE_ACTION_TOKEN }}
                  EXTERNAL_REPOSITORY: mackyan/mackyan.github.io
                  PUBLISH_BRANCH: main
                  PUBLISH_DIR: ./public
                  commit_message: ${{ github.event.head_commit.message }}

其中PERSONAL_TOKEN根据下图创建和使用:

总结

当完成以上环境的部署之后，接下来的常见操作就是：

1. hugo new posts/xxx.md新建文章（或者 hugo new posts/xxx/index.md）

2. 添加或修改文章内容

3. 上传push更新修改到GitHub

4. 自动执行github actions，生成静态文件，部署到xxx.github.io的github pages

5. 个人网站查看网页文章是否生效

参考资料

1. Hugo-PaperMod installation wiki
2. Hugo + GitHub Action，搭建你的博客自动发布系统
3. 搭建 Hugo 个人网站｜PaperMod 主题
4. 使用github actions自动部署hugo博客（隐藏网站根目录）
5. 给Hugo PaperMod增加giscus评论系统
6. PaperMod添加Follow RSS订阅认证