本文主要解决终端工具与charm环境隔离问题，让终端虚拟环境与pycharm进行关联，简化pycharm的操作

第一步 安装 UV 并创建虚拟环境

（uv工具安装步骤已经跳过，不知道怎么安装的找AI问）

确保系统中已安装 UV 工具。若需特定 Python 版本（如 3.12.10），可直接通过 UV 安装：

uv python install 3.12.10

1.使用pycharm打开项目，进入pycharm的terminal

在项目根目录创建虚拟环境：

uv venv --python 3.12.10

此命令会在当前目录生成 .venv 文件夹作为虚拟环境。

2.激活虚拟环境：

# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

上面步骤结束了一定要重启pycharm，否则不加载刚配置好的虚拟环境

第二步 配置pycharm

1.配置 PyCharm 解释器

在 PyCharm 中设置虚拟环境路径：

1. 进入 Settings > Project > Python Interpreter
2. 点击齿轮图标选择 Add Interpreter > Add Local Interpreter
3. 选择 UV 类型后切换至 Select Existing 标签页
4. Type选择“uv”，选择好之后，Environment会显示刚刚安装的虚拟环境

2.安装项目依赖

使用 UV 同步项目依赖（自动识别 pyproject.toml 或 requirements.txt）：

uv sync

安装完毕之后就可以继续接下来的调试工作了

以上步骤每个步骤需要pycharm反应成功后进行下一步操作，不能并行操作，否则会造成pycharm卡住无法工作

第三步 配置调试器

创建调试配置：

1. 点击 Add Configuration 并选择 Python 类型
2. 填写以下字段：
   • Script path: 后端入口文件（如 main.py 或 manage.py）
   • Parameters: Django 项目填写 runserver，其他留空
   • Python interpreter: 选择已配置的 .venv 解释器

设置断点后点击调试按钮（虫子图标）启动调试会话。

常见问题处理

PyCharm 不显示 UV 选项

• 确认 PyCharm 版本为 2023.3+
• 旧版本可手动选择 Existing Environment 并指向 .venv 中的解释器

终端未自动激活环境

• 检查 Settings > Tools > Terminal 中的 Shell 路径
• 手动执行激活命令：source .venv/bin/activate

依赖更新后 PyCharm 未识别

• 重启解释器索引：右下角点击解释器选择器 > Reload Interpreter
• 或执行 File > Invalidate Caches

常用命令参考

功能	命令示例
安装 Python	uv python install 3.12.10
创建虚拟环境	uv venv --python 3.12.10
安装依赖	uv sync
添加新包	uv add <package_name>