一、先确认电脑装好了 uv
在 PyCharm 下面的 Terminal 里输入
uv --version
如果能看到版本号，说明 uv 装好了
二、新建 PyCharm 项目时配置 uv
步骤
打开 PyCharm： New Project
然后找 Python 解释器/Interpreter 相关位置
选择 Environment type: uv
然后选 Python 版本,比如Python版本 3.10
创建完成后，PyCharm 通常会帮你生成项目文件，比如：
pyproject.toml
uv.lock
.venv/
main.py
PyCharm 帮你建了一个项目 ,uv 帮你建了一个虚拟环境 ,以后这个项目的包都装到 .venv 里
三、常用指令：必须掌握版
- 查看 uv 是否安装成功
uv --version
2. 创建虚拟环境
uv venv
3. 指定 Python 版本创建环境
uv venv --python 3.10
4. 激活虚拟环境
Windows PowerShell：
.venv\Scripts\Activate.ps1
Windows CMD：
.venv\Scripts\activate.bat
5. 退出虚拟环境
deactivate
6. 安装第三方库
uv pip install requests
7. 从 requirements.txt 安装
uv pip install -r requirements.txt
8. 查看已安装的库
uv pip list
9. 卸载库
uv pip uninstall requests
10. 导出依赖
uv pip freeze > requirements.txt
四、uv 项目模式常用指令
如果项目里有
pyproject.toml
uv.lock
更推荐用下面这些
- 初始化项目
uv init
2. 添加依赖
uv add requests
意思是: 安装 requests，并记录到 pyproject.toml
- 删除依赖
uv remove requests
4. 同步环境
uv sync
根据 pyproject.toml 和 uv.lock，把环境恢复到项目需要的状态
- 运行代码
uv run python main.py
五、总结
uv --version
uv venv
uv pip install 包名
uv pip install -r requirements.txt
uv pip list
uv pip freeze > requirements.txt
uv run python main.py
uv init
uv add 包名
uv sync
uv python install 3.12
uv python pin 3.12
核心就三步
1. 用 uv 创建 .venv
2. 让 PyCharm 的解释器选择这个 .venv
3. 用 uv add / uv pip install / uv run 管理和运行项目
uv venv
uv pip install requests
uv run python main.py
