PyCharm 与 uv：科学 Python 项目的平静起步工作流

对于一个小型科研项目，Python 环境是否清楚，比一开始看起来更重要。PyCharm 可以把代码、notebook、测试和项目文件放在同一个视野里；uv 则提供快速、可重复的环境创建和依赖安装方式。

1. 从项目根目录开始

在 PyCharm 中直接打开仓库根目录。一个项目最好有清晰的根目录，里面包含 pyproject.toml、源码、测试和文档。除非仓库本身按子项目拆分，否则不要只打开内部某个文件夹。

2. 用 uv 管理环境

uv 可以根据项目元数据创建和管理虚拟环境。在终端运行 uv sync 安装依赖。之后用 uv run 在这个环境里执行命令，例如 uv run pytest 或 uv run python script.py。

3. 让 PyCharm 使用同一个解释器

uv 创建 .venv 后，把 PyCharm 的解释器指向这个环境。这样编辑器检查、测试运行和终端命令会保持一致。如果终端里能 import，但编辑器里报错，优先检查解释器设置。

4. 让测试贴近工作流

科研代码的测试不必一开始就很复杂。几个小测试就有价值：检查已知数值、解析一个真实输出文件，或确认绘图/数据管线可以跑通而不崩溃。

5. 常用命令列表

• uv sync：安装项目依赖。
• uv run pytest：在受控环境里运行测试。
• uv add package-name：向项目添加依赖。
• uv run python -m module：通过环境运行模块。

关键习惯是保持一致：同一个项目根目录、同一个解释器、同一个命令入口。仅这一点就能消除很多配置问题，避免它们变成科研延误。