资源详情 · 实用工具
uv：跑通第一个 Python 小项目
用单独的练习目录建立 Python 项目，运行第一条问候，认识环境和依赖记录。
资源正文、示例和许可证保留原文。代码仅展示，不会在线执行或调用AI。
资源详情
适合正准备学习 Python、愿意练习少量终端命令的人。先完成本地问候程序，再逐步学习添加依赖；无需从编译 Rust 开始。
使用前准备
- 适用平台
- Windows · macOS · Linux
- 内容更新
- 能打开终端并进入自己可写的练习文件夹；先按官方页面安装 uv。
- 首次使用可能需要联网下载兼容的 Python；不必预先安装 Rust 编译器。
uv --version
uv init xiaobu-hello
cd xiaobu-hello
uv run xiaobu-hellouv init xiaobu-hello → cd xiaobu-hello → uv run xiaobu-hello。这里是终端命令，不是在 Python 交互提示符中逐句输入。
常见卡点
- 固定版本 uv 0.13.5 的官方项目教程使用 src 目录与命令入口；不强行套用旧版 main.py 布局。
- 包管理器会调用解释器、构建源码包或执行项目代码；安装包之前仍需确认来源。uv 不是不可信代码的隔离环境。
- Python 解释器、下载包和构建依赖有各自许可；主代码的 MIT 不自动覆盖它们。不要在已有工作项目中拿练习命令试错。
完整正文
【小目标】从零建立一个独立的 Python 练习项目，并运行生成的问候入口。
【开始前准备】能打开终端并进入自己可写的练习文件夹；先按官方页面安装 uv。
首次使用可能需要联网下载兼容的 Python；不必预先安装 Rust 编译器。
【三步尝试】1. 确认工具可用：按官方安装页选择对应系统的方法，重新打开终端并输入 uv --version，确认能显示版本号。
2. 建立自己的练习项目：在自己可写的位置输入 uv init xiaobu-hello，然后输入 cd xiaobu-hello。使用一个尚不存在的练习目录名。
3. 运行并认出生成文件：输入 uv run xiaobu-hello，核对问候输出；再认识 pyproject.toml、uv.lock 与 .venv。先保持这个练习没有外来依赖。
【检查结果】一条问候输出，以及自己能找到的 pyproject.toml、uv.lock 和 .venv。
【来源与许可】官方仓库 astral-sh/uv；固定提交 46776a95d6686ac0160c10611327ce491e6b202f，提交日期 2026-10-22（UTC）。2026-10-27 复核的稳定实用项目，不作为本轮实时热榜项目宣称。
uv 主代码提供 MIT OR Apache-2.0 二选一；本条明确选择 MIT 分支，完整保留 LICENSE-MIT 的版权、授权条件与免责声明。不会把两种许可写成必须同时遵守，也不把主代码许可套用到 Python、依赖、子组件或安装包的全部内容。
本站只提供原创导览和官方入口，导览按 CC BY 4.0 分享；不捆绑上游源码、安装包、图标、模型或用户素材。项目许可不自动覆盖依赖、商标、模型服务或托管平台，具体分发产物须另行核对。
2026-10-27 已只读核对官方固定提交的资料、完整许可和适用声明，按资料编写这份练习；本站未安装、登录或运行上游项目，也未进行安全审计。预期结果是供你自行核对的目标，不是本站实机测试记录。使用教程
从零建立一个独立的 Python 练习项目，并运行生成的问候入口。
确认工具可用
按官方安装页选择对应系统的方法，重新打开终端并输入 uv --version，确认能显示版本号。
建立自己的练习项目
在自己可写的位置输入 uv init xiaobu-hello，然后输入 cd xiaobu-hello。使用一个尚不存在的练习目录名。
运行并认出生成文件
输入 uv run xiaobu-hello，核对问候输出；再认识 pyproject.toml、uv.lock 与 .venv。先保持这个练习没有外来依赖。
预期输出
一条问候输出，以及自己能找到的 pyproject.toml、uv.lock 和 .venv。
2026-10-27 已只读核对官方固定提交的资料、完整许可和适用声明，按资料编写这份练习；本站未安装、登录或运行上游项目，也未进行安全审计。预期结果是供你自行核对的目标，不是本站实机测试记录。
适合用在哪里
- 适合正准备学习 Python、愿意练习少量终端命令的人。先完成本地问候程序，再逐步学习添加依赖；无需从编译 Rust 开始。
注意事项
- uv 主代码提供 MIT OR Apache-2.0 二选一；本条明确选择 MIT 分支，完整保留 LICENSE-MIT 的版权、授权条件与免责声明。不会把两种许可写成必须同时遵守，也不把主代码许可套用到 Python、依赖、子组件或安装包的全部内容。
- 固定版本 uv 0.13.5 的官方项目教程使用 src 目录与命令入口；不强行套用旧版 main.py 布局。
- 包管理器会调用解释器、构建源码包或执行项目代码；安装包之前仍需确认来源。uv 不是不可信代码的隔离环境。
- Python 解释器、下载包和构建依赖有各自许可；主代码的 MIT 不自动覆盖它们。不要在已有工作项目中拿练习命令试错。
原作者与来源
- 署名
- 本站导览
- 上游作者
- Astral Software Inc. 与 uv 贡献者；LICENSE-MIT 版权：Copyright (c) 2025 Astral Software Inc.
- 来源版本
46776a95d6686ac0160c10611327ce491e6b202f- 许可核对日期
- 2026-10-27
声明与修改说明
官方仓库 astral-sh/uv；固定提交 46776a95d6686ac0160c10611327ce491e6b202f，提交日期 2026-10-22（UTC）。2026-10-27 复核的稳定实用项目，不作为本轮实时热榜项目宣称。
完整许可证
CC BY 4.0
上游许可 · MIT
MIT License Copyright (c) 2025 Astral Software Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
验证范围
资料与许可已核对
只核对项目资料和许可记录；未安装运行上游项目，也未进行安全审计。
2026-10-27