代码收藏家技术教程 2025-05-21

Python UV开发环境搭建详解指南

Python-UV开发环境搭建指南

python-uv This repository contains configurations to set up a Python development environment using VSCode's Dev Container feature. The environment includes uv and Ruff. 项目地址: https://gitcode.com/gh_mirrors/py/python-uv

1. 项目基础介绍

本项目是一个开源项目，旨在利用VSCode的Dev Container特性来搭建一个Python开发环境。该环境包括了uv工具和Ruff代码格式化工具，可以帮助开发者提高开发效率和代码质量。主要使用的编程语言是Python。

2. 关键技术和框架

VSCode Dev Container: VSCode的一个特性，允许开发者在容器中开发，保证了开发环境的一致性。

uv: 一个工具，用于管理和运行Python项目，包括但不限于依赖管理、格式化、测试等。

Ruff: 一个快速的Python代码格式化工具，它可以替代多种其他格式化工具，如Flake8、Black、isort等。

3. 安装和配置

准备工作

在开始之前，请确保您的系统中已经安装以下软件：

Docker

Visual Studio Code

Git

安装步骤

克隆项目仓库

打开命令行窗口，运行以下命令来克隆项目仓库：
```
git clone https://github.com/a5chin/python-uv.git
cd python-uv
```
配置Dev Container

打开VSCode，进入克隆的项目目录，VSCode会自动检测到.devcontainer目录并询问是否打开配置文件。选择“Reopen in Container”。

如果没有自动提示，可以在VSCode中通过以下步骤手动配置：
按下 F1 打开命令面板
输入 Open Dev Container Configuration 并选择它
选择 create a new dev container with the .devcontainer configuration
安装依赖

在Dev Container环境中，运行以下命令安装项目依赖：
```
uv sync
```
如果您不希望安装开发依赖，可以使用以下命令：
```
uv sync --no-dev
```
运行项目

依赖安装完成后，您可以使用以下命令来运行项目：
```
uv run
```
这将启动项目，具体操作取决于项目的设置。
代码格式化与检查

在项目开发过程中，可以使用以下命令来格式化代码：
```
uv run ruff format .
```
使用以下命令来检查代码：
```
uv run ruff check .
```
如果需要修复检测到的问题，可以添加 --fix 参数。