Vscode使用uv配置虚拟环境的步骤以及常见的坑
·
基本流程:初始化项目(创建文件夹) → 创建虚拟环境 → 激活环境 → 安装依赖 → 绑定 VSCode 解释器
一、详细步骤
- 使用uv init
初始化项目(生成 pyproject.toml,这个文件主要是存放一些项目下载的依赖)
2.uv venv //自己定义虚拟环境名 uv venv 环境名 例:uv venv minmind
创建虚拟环境(默认为.venv文件)
3.激活 虚拟环境 .\环境名字\Scripts\Activate.ps1
例:.\minmind\Scripts\Activate.ps1
4. 使用 uv sync 下载pyproject.toml的依赖到这个环境当中
5.在vscode中选择对应的解释器
二、常见的问题
1.未激活就下载环境的依赖,则依赖安装到默认环境当中了
每一个项目都有一个独立虚拟环境,先激活环境,后安装依赖,然后绑定对应的解释器
2.发现多次安装虚拟的没有用,则强制在当前环境下安装
使用 uv sync -active
三、一键脚本,告别重复操作
批处理脚本(.bat),新建项目时双击就能完成所有配置:
@echo off
chcp 65001 > nul
set /p project_name=请输入新项目名称:
mkdir %project_name%
cd %project_name%
echo 正在初始化项目...
uv init
echo 正在创建虚拟环境...
uv venv
echo 正在激活虚拟环境...
call .\.venv\Scripts\Activate.ps1
echo 正在安装常用依赖(transformers、torch)...
uv add transformers torch
uv sync
echo 环境配置完成!
echo 请用 VSCode 打开 %project_name% 文件夹,并选择 .venv/Scripts/python.exe 作为解释器。
pause
对文档进行修改 比如依赖包
- 双击运行
init_project.bat; - 输入新项目名称(比如
test_project),回车; - 脚本会自动完成「创建文件夹 → 初始化项目 → 建环境 → 装依赖」所有步骤;
- 最后用 VSCode 打开项目,选解释器即可。
更多推荐



所有评论(0)