uv 备忘清单 === 一个用 Rust 编写的极快的 Python 包和项目管理工具 安装 --- ### 使用独立安装程序安装 #### macOS or Linux ```sh curl -LsSf https://astral.sh/uv/install.sh | sh ``` #### Windows ```sh powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ``` ### 通过PyPI ```sh # pip pip install uv ``` ```sh # pipx pipx install uv ``` 入门 --- ### 创建新项目 ```sh # 创建一个目录作为项目的根目录 uv init project_name ``` ```sh # 将当前目录作为项目的根目录 uv init ``` #### 项目的结构 ```sh . ├── .venv/ # 虚拟环境目录 │ ├── bin/ # 可执行文件 │ ├── lib/ # 安装的库 │ └── pyvenv.cfg # 虚拟环境配置 ├── .python-version # 指定 Python 版本 ├── README.md # 项目说明文档 ├── main.py # 主程序入口 ├── pyproject.toml # 项目配置与依赖声明 └── uv.lock # 依赖锁定文件（自动生成） ``` ### 管理项目依赖 #### 添加依赖 ```sh uv add requests ``` #### 指定依赖版本或替代来源 ```sh # 指定版本 uv add 'requests==2.28.1' # 指定来源 uv add git+https://github.com/psf/requests ``` #### 从`requirements.txt`迁移 ```sh uv add -r requirements.txt ``` #### 删除一个包 ```sh uv remove requests ``` #### 升级一个包 ```sh uv lock --upgrade-package requests ``` ### 运行脚本 指定脚本运行 ```sh uv run main.py ``` 指定Python版本运行 ```sh uv run --python 3.10 main.py ``` ### 构建项目 ```sh uv build ``` 构建结果存储在`dist`目录下