uv使用笔记

官方文档

• uv python list
  uv开发团队将现存所有python版本都整理到了官方仓库中，使用uv python list可以查看所有python版本，并显示哪些在本地安装好了。
• uv python install 3.12
  使用uv python install 3.12可以安装python3.12版本。
• uv pip list
  查看当前python虚拟环境下安装的所有包。
  uv + pip可以执行pip所有命令。但是执行过包更新操作后需要手动执行uv lock
• uv lock --upgrade-package requests
  更新指定包的版本
• uv sync
  根据项目中pyproject.toml文件中指定的python版本，安装对应的python版本。
• uv run --with rich example.py或者uv run --with rich --no-project example.py
  运行脚本，--with指定了依赖库
• uv add --script example.py 'requests<3' 'rich'
  将依赖关系自动写到脚本文件的meta信息中，实际是文件开头加一段注释
• uv add 和 uv remove
  添加和删除依赖关系
• uv run -- flask run -p 3000
  运行flask应用
• uv init --script example.py --python 3.12
  创建一个新的脚本

project

• uv init [project name] --python 3.12
  创建一个新的python项目，可以不指定py版本用默认的

• uv venv + source .venv/bin/activate
  创建虚拟环境并激活，跟python -m venv一样

• uv add "mcp[cli]" httpx
  安装依赖

• 国内使用问题
  官方默认python解释器下载源：https://github.com/indygreg/python-build-standalone/releases/download （实际上没有梯子是无法使用的）
  国内目前搜到南京大学的：https://mirror.nju.edu.cn/github-release/indygreg/python-build-standalone
  pypi国内可以用清华的：https://pypi.tuna.tsinghua.edu.cn/simple
  修改方法：

  • 对于python解释器下载
    1. 命令行--mirror
    2. 项目pyproject.toml中指定

       [tool.uv]
       python-install-mirror = 

    3. 用户级配置文件~/.config/uv/uv.toml中指定

       python-install-mirror = 

    4. 环境变量UV_PYTHON_INSTALL_MIRROR
  • 对于安装python lib（pypi）
    1. 命令行内指定uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple
    2. 项目pyproject.toml中指定

       [[tool.uv.index]]
       url = "https://pypi.tuna.tsinghua.edu.cn/simple"
       default = true

    3. 用户级配置文件~/.config/uv/uv.toml中指定
       [[index]]
       url = “https://pypi.tuna.tsinghua.edu.cn/simple“
       default = true
    4. 还可以通过环境变量[env: UV_INDEX_URL=]