先确认uv已安装（uv --version），再新建项目时在PyCharm中手动输入uv创建虚拟环境，或为已有项目通过uv venv/.venv或uv sync绑定环境，最后验证路径、sys.prefix及包索引是否正确。
确认系统已安装 uv 并可用
打开终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal），执行 【uv --version】。若返回类似 uv 0.4.20 的版本号，说明 uv 已正确安装并加入 PATH；若提示“命令未找到”，需先通过 pip install uv 或官网二进制方式安装 uv，并确保其所在目录已添加至系统环境变量。
新建项目时直接使用 uv 创建虚拟环境
启动 PyCharm → 新建项目（New Project）→ 在“Location”处指定项目路径 → 展开“Python Interpreter”设置区域 → 选择“New environment using” → 下拉菜单中【必须手动输入 uv】（PyCharm 当前版本不自动识别 uv，下拉列表默认只显示 Virtualenv/Conda/Pipenv，此时需点击右侧“…”按钮或直接在下拉框内键盘输入 uv）→ 确认 Base interpreter 指向本机 Python（如 C:\Users\Name\AppData\Local\Programs\Python\Python311\python.exe）→ 点击“Create”。
PyCharm 将调用 uv venv 命令在项目根目录下生成 .venv 文件夹，并自动将其设为当前项目的解释器。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
为已有项目手动绑定 uv 虚拟环境
方法一：通过终端创建后手动指定
在项目根目录打开终端 → 执行 uv venv .venv → 等待完成 → 返回 PyCharm → File → Settings → Project → Python Interpreter → 点击右上角齿轮图标 → Add → Local Interpreter → Conda Environment → 切换为“System Interpreter” → 点击“…”浏览 → 定位到项目目录下的 【.venv\Scripts\python.exe（Windows）或 .venv/bin/python（macOS/Linux）】 → 选中 → OK。
方法二：用 uv 同步 requirements.txt 后重绑
确保项目有 requirements.txt → 终端执行 uv sync（自动识别并安装）→ 关闭当前解释器配置窗口 → 重新进入 Settings → Python Interpreter → Add → Existing → 浏览并选中刚被 uv sync 初始化好的 .venv 中的 python 可执行文件 → OK。
验证 uv 环境是否生效
在 PyCharm 的 Terminal 中执行 which python（macOS/Linux）或 where python（Windows），输出路径应包含项目目录下的 .venv 子路径。
再运行 python -c "import sys; print(sys.prefix)"，返回值必须与 .venv 路径一致。
最后在编辑器中写一行 import requests，无红色波浪线且能正常跳转到源码，说明 uv 环境中的包已被 PyCharm 正确索引。
