配置 Python 环境
-
下载 python 解释器
-
下载 uv
pip install uv() -
在项目文件夹内新建
pyproject.tomltoml[project] name="a" version="0.0.0" -
执行
uv sync
python的依赖默认是全局的 每个项目都要开启虚拟环境 .venv(≈node_modules)
pyproject.toml是项目描述,功能与package.json类似
uv是社区推荐的工具,可以帮助开发者管理项目,会生成uv.lock文件锁依赖版本
uv也可以用于管理python版本
pyproject.toml
toml
# 例如pytest的配置
[tool.pytest.ini_options]
asyncio_mode = "auto"
[project] 是唯一的标准段;[tool.*] 段是各工具读自己的配置,互不干扰;
uv 常用命令
| 命令 | 作用 | npm 对标 |
|---|---|---|
uv sync |
按清单 + 锁文件安装全部依赖(自动建 .venv) | npm i |
uv add xxx |
添加运行时依赖 | npm i xxx |
uv add --dev xxx |
添加开发依赖 | npm i -D xxx |
uv remove xxx |
移除依赖 | npm rm xxx |
uv run xxx |
在项目虚拟环境里执行命令 | npx xxx |
uvx xxx |
临时跑一个不装进项目的工具 | npx -y xxx |
uv lock --upgrade |
升级锁文件里的依赖版本 | npm update |
uv python install 3.12 |
安装解释器 | nvm install |
format&lint
python项目使用ruff进行format&lint
下载ruff
shell
uv add --dev ruff
使用ruff
sh
uv run ruff format . # 格式化全部文件
uv run ruff check . # 只报告 lint 问题
uv run ruff check --fix . # lint 并修复
在 pyproject.toml 的 [tool.ruff.*] 配置ruff
类型
python的类型注解需要额外配置
下载pyright
sh
uv add --dev pyright
检查类型
sh
uv run pyright
在 pyproject.toml 的 [tool.pyright.*] 配置pyright的配置
编辑器配置
ruff插件 
vscode内置pylance 已经包含了pyright
python没有npm脚本之类的东西 可以在.vscode/tasks.json里配置任务