uv init
创建一个新项目。
遵循 pyproject.toml
规范。
如果目标位置已存在 pyproject.toml
,uv 将退出并报错。
如果在目标路径的任何父目录中找到 pyproject.toml
,该项目将被添加为父项目的工作区成员。
某些项目状态在需要时才会创建,例如,项目虚拟环境(.venv
)和锁文件(uv.lock
)在首次同步时才会延迟创建。
Usage
Arguments
[PATH]
用于项目/脚本的路径
Options
--name
项目的名称
--bare
仅创建 pyproject.toml
--package
将项目设置为构建为 Python 包
--no-package
不将项目设置为构建为 Python 包
--app
为应用程序创建项目
--lib
为库创建项目
--script
创建脚本
--description
设置项目描述
--no-description
禁用项目描述
--vcs
为项目初始化版本控制系统 [可能的值:git, none]
--build-backend
为项目初始化选择的构建后端 [可能的值:hatch, flit, pdm, poetry, setuptools, maturin, scikit]
--no-readme
不创建 README.md
文件
--author-from
填写 pyproject.toml
中的 authors
字段 [可能的值:auto, git, none]
--no-pin-python
不为项目创建 .python-version
文件
--no-workspace
避免发现工作区并创建独立项目
Python options
-p, --python
用于确定最低支持 Python 版本的 Python 解释器。[env: UV_PYTHON=]
--managed-python
要求使用 uv 管理的 Python 版本 [env: UV_MANAGED_PYTHON=]
--no-managed-python
禁用 uv 管理的 Python 版本 [env: UV_NO_MANAGED_PYTHON=]
--no-python-downloads
禁用 Python 的自动下载。[env: "UV_PYTHON_DOWNLOADS=never"]
Cache options
-n, --no-cache
避免读取或写入缓存,而是在操作期间使用临时目录 [env: UV_NO_CACHE=]
--cache-dir
缓存目录的路径 [env: UV_CACHE_DIR=]
Global options
-q, --quiet...
使用静默输出
-v, --verbose...
使用详细输出
--color
控制输出中颜色的使用 [可能的值:auto, always, never]
--native-tls
是否从平台的本机证书存储加载 TLS 证书 [env: UV_NATIVE_TLS=]
--offline
禁用网络访问 [env: UV_OFFLINE=]
--allow-insecure-host
允许与主机的不安全连接 [env: UV_INSECURE_HOST=]
--no-progress
隐藏所有进度输出 [env: UV_NO_PROGRESS=]
--directory
在运行命令之前切换到给定目录
--project
在给定项目目录中运行命令 [env: UV_PROJECT=]
--config-file
用于配置的 uv.toml
文件路径 [env: UV_CONFIG_FILE=]
--no-config
避免发现配置文件(pyproject.toml
、uv.toml
)[env: UV_NO_CONFIG=]
-h, --help
显示此命令的简洁帮助