当前位置：首页 > news >正文

【Python】UV：单脚本依赖管理

news 来源：原创 2025/7/16 7:21:29

一、基础概念

什么是 Python 脚本
- 以 .py 结尾的文件，可通过 python script.py 独立执行。
- UV 工具优势：无需手动创建或激活虚拟环境，自动为每个脚本生成隔离环境，保证依赖互不干扰。
环境管理原理
```
graph LRA[系统 Python 环境] --> B[虚拟环境隔离]B --> C[UV 自动创建临时环境]
```
- 当执行 uv run 时，UV 会自动在后台生成一个临时虚拟环境，仅安装当前脚本所需的依赖，脚本执行完毕后可复用或销毁该环境。

提示：如果不熟悉虚拟环境，可参考 Python 自带的 venv 模块。uv 会在后台帮你管理环境，并且推荐“声明式”地在脚本里写明依赖。

学习建议：

从无依赖脚本起步，熟悉 uv run 基本用法；
再尝试临时依赖模式，理解 --with；
最终过渡到内联依赖，编写更稳定、可复现的脚本。
遇到问题时，uv run --verbose 脚本.py 可查看详细执行日志，帮助排查。

二、基础使用

1. 无依赖脚本

# hello.py
print("你好，世界！")
$ uv run hello.py
你好，世界！

无额外依赖时，直接运行即可。

2. 带命令行参数

# greet.py
import sys
print(" ".join(sys.argv[1:]))
$ uv run greet.py 你好 Python
你好 Python

命令行参数会按顺序传入脚本，sys.argv[1:] 即所有参数列表。

3. 从标准输入读取

$ echo 'print("stdin 运行!")' | uv run -
stdin 运行!

或使用 here-doc：

$ uv run - <<EOF
print("多行脚本测试")
EOF
多行脚本测试

项目模式
如果当前目录包含 pyproject.toml，uv run 会默认安装项目依赖。
如只想运行脚本并忽略项目本身，需在命令前加 --no-project：
uv run --no-project hello.py

三、依赖管理

1. 临时依赖（单次运行）

适合偶尔需要外部库，但不想在脚本里永久添加依赖的场景。

# progress.py
from rich.progress import track
for _ in track(range(10), description="加载中"):pass
$ uv run --with rich progress.py
加载中 ━━━━━━━━━━━━━━ 100% 0:00:00

--with rich：当前执行临时安装并使用 rich 库。
可多次使用 --with 添加多个包。

2. 永久依赖（内联声明）

推荐做法，在脚本顶部声明依赖，UV 会自动识别并安装。

# /// script
# dependencies = ["requests", "rich"]
# ///import requests
from rich import printresp = requests.get("https://api.example.com")
print(resp.status_code, resp.text)

管理命令：

$ uv add --script demo.py requests rich

该命令会在脚本头部生成或更新 dependencies 列表。
后续直接 uv run demo.py 即可，无需再加 --with。

注意：使用内联依赖时，若在项目目录下运行，也不会安装项目依赖，脚本只关心自己声明的包。

四、相关管理命令

功能场景	命令示例	说明
指定 Python 版本	`uv run --python 3.10 demo.py`	若本地无该版本，UV 会自动下载并使用
锁定依赖版本	`uv lock --script demo.py`	生成 `demo.py.lock`，用于可重复运行
导出依赖清单	`uv export --script demo.py`	输出 `requirements.txt` 或等效格式，方便分享
查看依赖树	`uv tree --script demo.py`	以树状结构展示当前脚本依赖及其互相引用
移除脚本依赖	`uv remove --script demo.py package_name`	从内联声明中删除指定包
清理环境	`uv clean demo.py`	删除该脚本对应的虚拟环境，以便重新创建
使用私有源	`uv add --index https://私有源/simple --script demo.py 包名`	将私有索引写入脚本元数据，支持认证
导出锁文件	`uv export --lock demo.py.lock`	将锁文件内容导出为可阅读格式
查看脚本信息	`uv info --script demo.py`	显示已声明依赖、Python 版本需求、索引源等元数据信息
项目依赖安装（全局）	`uv install`	在项目目录安装 `pyproject.toml` 中定义的所有依赖
版本升级	`uv upgrade [package]`	升级指定包或全部包到最新版本
环境诊断	`uv doctor`	检查 UV 配置和环境问题，给出修复建议

五、最佳实践

创建可执行脚本（类 Unix 系统）
在脚本顶部添加 shebang，可直接双击或命令行执行，无需写命令。
```
#!/usr/bin/env -S uv run --script
print("脚本可执行！")
```
授予执行权限：
```
chmod +x script
./script
```

跨平台 GUI 开发

Windows 下使用 .pyw 扩展，UV 会用 pythonw 运行，无控制台窗口。
同样支持依赖管理：

# app.pyw
from tkinter import Tk, Label
root = Tk()
Label(root, text="UV GUI 示例").pack()
root.mainloop()

uv run --with PyQt5 app.pyw

六、常见问题

Q1：为何出现 ModuleNotFoundError？
A：说明脚本缺少依赖声明，可用

uv add --script 脚本.py 包名

或在执行时临时加 --with 包名。

Q2：如何保证他人环境也能正常运行？
A：使用锁定命令：

uv lock --script 脚本.py

生成 .lock 文件后，可与他人一同分享，确保安装相同版本的依赖。

【Python】UV：单脚本依赖管理

一、基础概念什么是 Python 脚本以 .py 结尾的文件，可通过 python script.py 独立执行。UV 工具优势：无需手动创建或激活虚拟环境，自动为每个脚本生成隔离环境，保证依赖互不干扰。环境管理原理 graph LRA[系统 Python 环境] -…...

编程日记 2025/7/16 7:21:29

多线程（2）——Thread类及常见方法

目录构造方法常见属性前台线程，后台线程启动一个线程——start()中断（终止）一个线程方法1：通过变量方法2：使用 isInterrupted() ---线程内置的标志位等待一个线程——join()join设置等待时间获取当前线程引用---cu…...

编程日记 2025/7/16 5:23:17

Neo4j 入门级使用

一、集成步骤 （一）创建 Spring Boot 项目使用 Spring Initializr 创建项目时，选择 Maven 或 Gradle 作为项目构建工具，选择合适的 Spring Boot 版本，并添加 “Spring Data Neo4j” 依赖。 （二&#xff…...

编程日记 2025/6/29 3:56:43

解决 CJSON 浮点数精度问题：从 `cJSON_AddNumberToObject` 到 `cJSON_AddRawToObject`

在使用 CJSON 库处理浮点数时，开发者常会遇到一个棘手问题：浮点数的小数位精度丢失。例如，数值 3.1400 可能被简化为 3.14，甚至 5.0 被显示为 5。这种默认行为在需要严格保留小数位的场景（如金融、物联网传感数据&…...

编程日记 2025/7/15 11:07:20

ESP32开发入门(九)：HTTP服务器开发实践

一、HTTP服务器基础 1.1 什么是HTTP服务器？ HTTP服务器是能够处理HTTP请求并返回响应的网络服务程序。在物联网应用中，ESP32可以作为轻量级HTTP服务器，直接接收来自客户端(如浏览器、手机APP)的请求。 1.2 ESP32作为HTTP服务器的特点轻量…...

编程日记 2025/7/14 14:34:19

谱聚类，大模型

使用谱聚类将相似度矩阵分为2类的步骤如下： 1. **构建相似度矩阵**：提供的1717矩阵已满足对称性且对角线为1。 2. **计算度矩阵**：对每一行求和得到各节点的度，形成对角矩阵。 3. **计算归一化拉普拉斯矩阵**：采用对…...

编程日记 2025/6/29 3:26:55

K8S Ingress、IngressController 快速开始

假设有如下三个节点的 K8S 集群： k8s31master 是控制节点 k8s31node1、k8s31node2 是工作节点容器运行时是 containerd 一、理论介绍 1）什么是 Ingress 定义：Ingress 是 Kubernetes 中的一种资源对象，它定义了外部访问集群内…...

编程日记 2025/7/15 2:08:15

AI边缘网关_5G/4G边缘计算网关厂家_计讯物联

AI边缘网关是边缘计算与人工智能技术深度融合的产物，作为连接终端设备与云端的桥梁，在网络边缘实现数据采集、实时分析、智能决策和协议转换，显著降低了数据传输延迟，节省了云端资源，并提升了隐私保护能力，…...

编程日记 2025/6/29 1:43:03

【Vue】Composables 和 Utils 区别

1. 核心功能与状态管理 • Composables 用于封装有状态的逻辑，通常结合 Vue 的响应式 API（如 ref、reactive）和生命周期钩子（如 onMounted），可管理组件内部的状态和副作用。例如，封装鼠标位置…...

编程日记 2025/7/14 16:25:23

右值和移动

值类别(value categories) lvalue 通常可以放在等号左边的表达式, 左值例子变量，函数或数据成员的名字返回左值引用的表达式，如x, x 1, cout << ’ . x 1 和 x返回的都是对x的int&. x则返回的是int字符串字面量如 “hello world” rva…...

编程日记 2025/6/29 4:37:27

如何在 Bash 中使用 =~ 操作符？

在 Bash 脚本世界中，有各种操作符可供我们使用，使我们能够操作、比较和测试数据。其中一个操作符是 ~ 操作符。这个操作符经常被忽视，但功能非常强大，它为我们提供了一种使用正则表达式匹配字符串模式的方法。 ~ 操作符语法语法…...

编程日记 2025/6/29 2:33:11

消息队列RocketMQ-docker部署保姆级教程（从0到1）（2）

目录引言 1. 准备工作 1.1 准备虚拟机 1.2 将虚拟机的ip设置为静态ip地址 1.3 什么是nat网络 1.4 测试网络 2. 准备docker环境 2.1 卸载旧docker（如果有） 2.2 安装依赖包 2.3 添加 Docker 官方仓库（国内推荐使用阿里云镜像&#xf…...

编程日记 2025/6/29 2:13:25

《算法导论(第4版)》阅读笔记：p32-p38

《算法导论(第4版)》学习第 12 天，p32-p38 总结，总计 7 页。一、技术总结 1.analyzing algorithms (1)running time(运行时间) worst-case running time, average-case running time，best-case running-time。 2.order of growth/rate …...

编程日记 2025/6/29 4:02:17

《Effective Python》第1章 Pythonic 思维详解——深入理解流程控制中的解构利器match

《Effective Python》第1章 Pythonic 思维详解——深入理解流程控制中的解构利器match 引言 Python 3.10 引入了全新的 match 语句，它不仅是一个“类 switch”的语法结构，更是一种**结构化模式匹配（structural pattern matching&#xff09…...

编程日记 2025/6/29 3:40:55

【氮化镓】横向GaN 器件注入隔离区的电场相关载流子传输特性

文章的关键结论和发现如下：在GaN横向功率器件中，注入隔离区的载流子传输具有明显的电场依赖性，且其泄漏电流和击穿特性主要由注入的GaN区域决定，与缓冲层和UID GaN层的性质关系不大。载流子传输机制随电场强度变化呈现三个不同区域：低电场下为欧姆传导，符合变程跃迁（V…...

编程日记 2025/6/29 4:20:08

电子电器架构 --- 借力第五代架构，驱动汽车产业创新引擎

我是穿拖鞋的汉子，魔都中坚持长期主义的汽车电子工程师。老规矩，分享一段喜欢的文字，避免自己成为高知识低文化的工程师： 钝感力的“钝”，不是木讷、迟钝，而是直面困境的韧劲和耐力，是面对外界…...

编程日记 2025/6/29 4:10:38

【ROS2】通信部署概述（以话题（Topic）通信为例）

写在前面很多内容参考了赵虚左老师的ROS2教程概念说明工作空间：相当于一个项目，比如一台机械臂，或者一个机器人功能包：相当于一个项目中的一台设备，如电机、雷达、相机等大概构建流程以话题通信机制为例创…...

编程日记 2025/6/29 3:07:09

1.8 梯度

（知识体系演进逻辑树） 一元导数（1.5） │ ├─→ 多元偏导数（1.6核心突破） │ │ │ └─解决：多变量耦合时的单变量影响分析 │ │ │ ├─几何：坐标轴切片切线斜率…...

编程日记 2025/6/29 2:23:52

Pycharm中No Conda enviroment selected

最近在学习Anaconda，换了台新电脑重新安装PyCharm和Anaconda后，打算创建环境，创建后发现找不到刚刚在Anaconda中创建的环境，经过不断摸索后找到解决方案将选择的路径从Anaconda目录下的python.exe换成Anaconda\Library\bin下的c…...

编程日记 2025/6/29 3:14:59

continue通过我们的开源 IDE 扩展和模型、规则、提示、文档和其他构建块中心，创建、共享和使用自定义 AI 代码助手

一、软件介绍文末提供程序和源码下载 Continue 使开发人员能够通过我们的开源 VS Code 和 JetBrains 扩展以及模型、规则、提示、文档和其他构建块的中心创建、共享和使用自定义 AI 代码助手。二、功能 Chat 聊天 Chat makes it easy to ask for help from an LLM without…...

编程日记 2025/6/29 4:51:33

同一线程的两种情况： 读读： public static void main(String[] args) throws InterruptedException {ReentrantReadWriteLock lock new ReentrantReadWriteLock();Lock readLock lock.readLock();Lock writeLock lock.writeLock();readLock.lock();S…...

编程日记 2025/6/29 4:35:03

Ubuntu网络部署LNMP环境

目录 1. 安装nginx 2. 安装mysql 3. 安装PHP 4. 配置nginx，修改默认配置文件 5. 配置PHP 1. 安装nginx apt install -y nginx#开启 systemctl start nginx#浏览器访问页面 192.168.180.200:80#nginx网页html存放路径 ls /usr/share/nginx/#查看nginx版本号 ng…...

编程日记 2025/6/29 2:35:06

榜单按行显示

手机芯片_SoC天梯榜_安兔兔跑分排行_安兔兔我只关注骁龙7Gen1，天玑7300，骁龙6Gen1，天玑900 除了 50,64,75,86 行都隐藏。 var uls document.getElementsByClassName(newrank-c); var s 50,64,75,86; var sa s.split(,); for (var i0…...

编程日记 2025/6/29 3:07:21

DVWA在线靶场-xss部分

目录 1. xxs（dom） 1.1 low 1.2 medium 1.3 high 1.4 impossible 2. xss（reflected） 反射型 2.1 low 2.2 medium 2.3 high 2.4 impossible 3. xss（stored）存储型 --留言板 3.1 low 3.2 medium 3.3 high 3.…...

编程日记 2025/6/29 1:39:36

将本地文件上传到云服务器上

使用 SCP 命令（最常用） # 基本语法 scp [本地文件路径] [用户名][服务器IP]:[目标路径]# 示例：上传单个文件 scp /path/to/local/file.txt root192.168.1.100:/path/to/remote/# 上传整个目录 scp -r /path/to/local/directory root192.168.…...

编程日记 2025/6/29 3:36:28

关系实验课--笛卡尔积

import sympy as sym a, b sym.symbols(a b) # 定义符号 a 和 b A sym.FiniteSet(a,b) # 创建包含 a 和 b 的有限集合 B sym.FiniteSet(1,2,3,4) AxB sym.cartes(A,B) # 返回迭代器。迭代器不会直接显示内容，而是需要手动遍历或转换为其他数据类型（如…...

编程日记 2025/6/29 2:39:18

从0开始学习大模型--Day07--大模型的核心知识点

AI常见名词知识库分为传统知识库与AI知识库，前者是单纯的存储各个领域的知识，后者则是与LLM结合，使AI系统能够更好地利用本地知识来响应查询和执行任务。比如，假如公司新来了个维修人员，他可以直接调用AI知识库去学…...

编程日记 2025/6/29 1:48:28

无线定位之二 SX1302 网关源码 thread_down 线程详解

前言笔者计划通过无线定位系列文章、系统的描述 TDOA 无线定位和混合定位相关技术知识点, 并以实践来验证此定位系统精度。笔者从实践出发、本篇直接走读无线定位系统关键节点、网关 SX1302 源码框架,并在源码走读过程中、着重分析与无线定位相关的PPS时间的来龙去脉、并在…...

编程日记 2025/6/29 5:03:55

MINIX 1.0 文件系统的实现(C/C++实现)

MINIX 1.0 文件系统简介： Linux 0.11操作系统启动时需要加载一个根目录，此根目录使用的是MINIX 1.0文件系统，其保存在硬盘的第一个分区中。Linux 0.11操作系统将硬盘上的两个连续的物理扇区（大小为512字节）做为一个物理…...

编程日记 2025/6/29 4:15:01

Spring Data Elasticsearch 中 ElasticsearchOperations 构建查询条件的详解

Spring Data Elasticsearch 中 ElasticsearchOperations 构建查询条件的详解前言一、引入依赖二、配置 Elasticsearch三、创建模型类（Entity）四、使用 ElasticsearchOperations 进行 CRUD 操作1. 保存数据（Create）2. 获取数据&am…...

编程日记 2025/7/14 19:23:58

keil 解决 Error: CreateProcess failed, Command: ‘XXX\ARM\ARMCC\bin\fromelf.exe

参考文章链接： https://blog.csdn.net/qq_39172792/article/details/145499880 自己的： D:\Program Files\keil529\Keil_v5\ARM\ARMCLANG\bin\fromelf.exe --bin -o …/…/firmware_bin/L.bin ./Object/L.axf...

编程日记 2025/6/29 4:00:11

针对面试-mysql篇

1.如何定位慢查询? 1.1.介绍一下当时产生问题的场景(我们当时的接口测试的时候非常的慢，压测的结果大概5秒钟))，可以监测出哪个接口，最终因为是sql的问题 1.2.我们系统中当时采用了运维工具(Skywalkin就是2秒，一旦sql执行超过2秒…...

编程日记 2025/6/29 1:36:09

HNUST软件测试B考前最终复习

最近根据各个专业整理的考试重点，这两天总结出了以下内容，并附上了我自己复习的一些记忆小技巧，供大家参考，大家就图一乐。希望对你们的复习有所帮助，预祝大家考试顺利，加油！ 本次考试和去年的题…...

编程日记 2025/6/29 1:36:05

网络编程epoll和udp

# epoll模型核心要点## 1. epoll核心概念### 1.1 高效IO多路复用- 监视列表与激活列表分离- 内核使用红黑树存储描述符- 边缘触发模式(EPOLLET)支持### 1.2 事件触发机制- **水平触发(LT)**：- 默认模式，类似select/poll- 数据未读完持续触发事件- **边缘…...

编程日记 2025/6/29 1:36:16

【速写】use_cache参数与decode再探讨

序言纳什最近指出一个小细节，比如在Qwen系列模型中，两个special token： eos_token(<|im_end|>): 151645（im_end 中的 im 指的是 instruct message）pad_token(<|endoftext|>): 151643。这是很有趣的事…...

编程日记 2025/6/29 1:36:12

智能网联汽车“内外协同、虚实共生”的通信生态

编程日记 2025/6/29 1:36:11

《Python星球日记》第64天：NLP 概述与文本预处理

名人说：路漫漫其修远兮，吾将上下而求索。—— 屈原《离骚》创作者：Code_流苏(CSDN)（一个喜欢古诗词和编程的Coder😊） 目录一、NLP 简介1. 什么是自然语言处理？NLP 的应用场景： 2.…...

编程日记 2025/7/1 11:37:11

Java中堆栈

文章目录 Java中堆栈1. 栈（Stack）特点示例 2. 堆（Heap）特点示例 3. 核心区别4. 常见问题5. 内存可视化示例内存布局示意图： 总结 Java中堆栈在 Java 中，“堆栈” 通常指的是堆（Heap&#xff0…...

编程日记 2025/6/29 4:53:44

模块化PCB设计中联排半孔的应用

随着电子产品的快速发展，高密度、多功能和小型化已成为未来的趋势。电路板上的元件几何指数在增加，而PCB尺寸却越来越小，因此需要与支撑板做配合。如果用助焊剂将圆孔焊接到母板上，由于圆孔体积较大，会产生冷焊&#x…...

编程日记 2025/6/29 3:40:04

xss-lab靶场4-7关基础详解

前言： 仅作为练习，复盘推荐html在线运行平台，弹窗标签可以在平台运行，看语句是否能正常弹窗 HTML/CSS/Javascript在线代码运行工具 | 菜鸟教程内容： 第四关打开一看，输入<script>alert(1)&l…...

编程日记 2025/6/29 4:39:08

【Linux】进程状态、优先级、切换和调度

目录一、传统操作系统进程状态 （一）什么是状态 （二）运行状态 （三）阻塞状态 （四）挂起状态二、Linux进程状态 （一）进程状态 （二&#xff…...

编程日记 2025/7/15 4:38:11

软件测试基础知识详解

🍅 点击文末小卡片，免费获取软件测试全套资料，资料在手，涨薪更快 1、黑盒测试、白盒测试、灰盒测试 1.1 黑盒测试黑盒测试又叫功能测试、数据驱动测试或基于需求规格说明书的功能测试。该类测试注重于测试软件的功能性需…...

编程日记 2025/7/4 14:01:05

【WordPress博客AI内容辅助生成/优化工具箱插件下载无标题】

主要功能 AI内容生成/优化使用AI模型生成或优化段落内容支持撤销和模型切换 AI自动评论智能分析文章内容生成相关评论可配置的评论数量和随机调度生成评论回复的概率(评论数>10时) 可能以特定概率包含表情符号 AI标签提取从文章内容自动提取相关标签新标签可自动生…...

编程日记 2025/6/29 1:36:45

js 画立方体软件开发日记2

我不懂但我大为震惊重开几次又回去了这说明之前的操作无效搞了个调试当前文件导出模块有问题，跑显示没事启动太慢，重构吧 ----------------------------------------------- 把那些鬼相机投影代码删了就有4s了按钮全删了，还是卡&…...

编程日记 2025/6/29 1:36:19

element plus el-table多选框跨页多选保留

一、基础多选配置通过 type“selection” 开启多选列，并绑定 selection-change 事件获取选中数据 <template><el-table :data"tableData" selection-change"handleSelectionChange"><el-table-column type"selection&qu…...

编程日记 2025/6/29 1:36:36

智能家居“心脏“升级战：GD25Q127CSIG国产芯片如何重构家庭物联生态

在智能家居设备出货量突破10亿台的2023年，家庭网关正经历着前所未有的技术革新。作为连接云端与终端设备的中枢神经，智能网关的存储芯片选择直接决定着整个智能生态系统的运行效率。在这场技术升级浪潮中，兆易创新GD25Q127CSIG串行闪存芯片主…...

编程日记 2025/7/8 10:27:42

智能枪弹柜管理系统|智能枪弹柜管理系统LK-QDG-Q20型

是一种用于存放枪支弹药的智能化设备，主要应用于涉枪单位，以下将从其功能特点、系统组成、优势等维度展开介绍： 功能特点身份识别功能：采用多种生物识别技术，如指纹识别、指静脉识别、虹膜识别、人脸识别、声纹识别等…...

编程日记 2025/6/29 3:43:55

bootstrap table 添加跳转到指定页的功能(仅自己可见)

Table回调方法中，添加input和button至Table下方（Table页渲染结束后执行） （input用来输入页码，button执行跳转） function ajaxRequestExtends(data){$(".page-list").append("<input idp…...

编程日记 2025/6/29 3:57:27

rufus+Ubuntu 18.04 镜像

参考：https://blog.csdn.net/Li060703/article/details/106075597 Rufus 官网： https://rufus.ie/zh/ 步骤安装U盘做好后插在主板io的USB口上，启动阶段用F2或DEL打断进bios，bios里面指定从安装U盘来启动，里面的B…...

编程日记 2025/6/29 3:58:25

基于事件驱动和策略模式的差异化处理方案

一、支付成功后事件驱动 1、支付成功事件 /*** 支付成功事件** author ronshi* date 2025/5/12 14:40*/ Getter Setter public class PaymentSuccessEvent extends ApplicationEvent {private static final long serialVersionUID 1L;private ProductOrderDO productOrderDO;…...

编程日记 2025/6/29 1:36:29