Esta página contiene algunos consejos sobre errores y problemas comúnmente encontrados durante el desarrollo de aplicaciones de Django.
django-admin¶django-admin debe estar en tu ruta de sistema si instalaste Django mediante pip. Si no está en tu ruta, asegúrate de tener activado tu entorno virtual y puedes intentar ejecutar el comando equivalente python -m django.
Si estás utilizando macOS, es posible que veas el mensaje «denegada la permiso» cuando intentes ejecutar django-admin. Esto se debe a que, en sistemas basados en Unix como macOS, un archivo debe estar marcado como «ejecutable» antes de poder ser ejecutado como programa. Para hacer esto, abre Terminal.app y navega (utilizando el comando cd) al directorio donde está instalado django-admin, luego ejecuta el comando sudo chmod +x django-admin.
UnicodeDecodeError. ¿Qué estoy haciendo mal?¶Esta clase de errores ocurren cuando una cadena de bytes que contiene secuencias no ASCII se transforma en una cadena Unicode y la codificación especificada es incorrecta. El resultado generalmente tiene el siguiente aspecto:
UnicodeDecodeError: 'ascii' codec can't decode byte 0x?? in position ?:
ordinal not in range(128)
La resolución depende principalmente del contexto, sin embargo aquí hay dos trampas comunes que producen este error:
Tu sistema de localización puede ser una localización ASCII por defecto, como la «C» en sistemas UNIX-like (puedes verificarlo con el comando locale). Si es así, consulta la documentación de tu sistema para saber cómo cambiarla a una localización UTF-8.
Recursos relacionados:
may 31, 2026