使用pycharm调试后端项目

本文主要解决终端工具与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类型后切换至SelectExisting标签页
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

常用命令参考