Buenas prácticas en Python uv: checklist de estabilidad y colaboración
2 min read
En la práctica, los problemas suelen venir de procesos y hábitos, no de la herramienta.
Prácticas recomendadas
1) Commitear siempre uv.lock
Es la base de reproducibilidad entre máquinas, equipo y CI.
2) Nunca commitear .venv
Es artefacto local y debe estar en .gitignore.
3) Acotar versiones de dependencias
Evita requests sin rango; mejor requests>=2.31,<3.
4) En CI usar uv sync o uv pip sync
- run: uv sync
- run: uv run pytestPrimero sincronizar, luego ejecutar.
5) Herramientas de desarrollo en --dev
uv add --dev pytest ruff mypyErrores comunes
Error 1: mezclar pip install y uv add
Puede desincronizar lockfile y entorno.
Error 2: usar uvx para tools del proyecto
Tools fijadas por versión del proyecto -> uv add --dev + uv run.
Error 3: editar pyproject manual sin cuidado
Para dependencias, preferir uv add / uv remove.
Error 4: no instalar uv en CI
Instala uv oficialmente y evita resolver todo con pip tradicional.
Error 5: no definir requires-python
Especifica versión mínima para evitar incompatibilidades.
Este checklist no elimina todos los incidentes, pero reduce muchos errores evitables.