如何安装并使用 uv：创建 Python 项目、添加依赖并运行脚本

按官方步骤安装 uv，初始化项目、添加一个包，并用 uv run 执行脚本。

要在本机用 uv 管 Python 项目，先完成四件事：按官方方式安装，uv init 建项目，uv add 加一个包，再用 uv run 跑脚本。

按 docs.astral.sh/uv/ 走，不要猜安装包名。核心检索词是 如何安装 uv、uv init，以及 uv run 运行脚本。安装入口在 astral.sh/uv。

先按系统装官方二进制

安装、建项目、加包、跑脚本

1. 01
   安装并确认版本

   按 docs.astral.sh/uv/getting-started/installation/ 选脚本或 Homebrew。装完 uv --version 应打印版本。找不到命令就重开终端，检查 PATH。

2. 02
   创建项目

   在目标父目录执行 uv init myproject，再 cd myproject。应看到 pyproject.toml。已有空目录可用 uv init 就地初始化。

3. 03
   添加一个包

   执行 uv add httpx（示例）。uv 会解析依赖、写锁文件并准备环境。失败时核包名与网络，不要手改半截锁文件。

4. 04
   写脚本并运行

   新建 hello.py，用刚加的包写几行可执行代码，然后 uv run python hello.py。需要固定解释器时先 uv python install。

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# 写好 hello.py 后：
uv run python hello.py

必须用官方安装脚本吗？

不必。文档还列出 Homebrew、WinGet 等渠道。选一种，装完用 uv --version 验证即可。不要混装多个互抢 PATH 的副本。

还要自己建 venv 吗？

日常不必。uv add 与 uv run 会使用项目虚拟环境。把 .venv 加入 .gitignore，不要提交环境目录。

uv run 和直接 python 有何不同？

直接调用系统 python 可能看不到项目依赖。uv run 会按项目配置选用解释器与已安装的包。

装完就能当白板用吗？

不能。这是 Python 工具链。要对着同一张图说话时，再开 sitdraw。