配置 Python 环境
- 下载 python 解释器
- 下载 uv
pip install uv() - 在项目文件夹内新建
pyproject.toml[project] name="a" version="0.0.0" - 执行
uv sync
python的依赖默认是全局的 每个项目都要开启虚拟环境 .venv(≈node_modules)
pyproject.toml是项目描述，功能与package.json类似
uv是社区推荐的工具，可以帮助开发者管理项目，会生成uv.lock文件锁依赖版本
uv也可以用于管理python版本
pyproject.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
uv add --dev ruff
使用ruff
uv run ruff format . # 格式化全部文件
uv run ruff check . # 只报告 lint 问题
uv run ruff check --fix . # lint 并修复
在 pyproject.toml 的 [tool.ruff.*] 配置ruff
类型
python的类型注解需要额外配置
下载pyright
uv add --dev pyright
检查类型
uv run pyright
在 pyproject.toml 的 [tool.pyright.*] 配置pyright的配置
编辑器配置
ruff插件
vscode内置pylance 已经包含了pyright
python没有npm脚本之类的东西 可以在.vscode/tasks.json里配置任务
