Instalar Python y VS Code en macOS
Instalar Python y VS Code en un Mac usando una sola ruta y confirmar que ambos funcionan.
Cómo utilizar esta lección
Hacé un paso a la vez. Después de cada paso compara tu pantalla con el resultado esperado.
No marques el checklist por leer: márcalo únicamente después de probar.
Antes de comenzar
🎯 Qué vas a lograr en esta lección
¿Qué problema vas a resolver?
Aprenderás a instalar y verificar python y vs code usando una única ruta controlada. La idea es partir de una necesidad concreta, no de memorizar código.
¿Qué vas a construir?
Macos Installation Checker: un proyecto pequeño para preparar una herramienta de trabajo. El nombre técnico identifica la carpeta del proyecto; no necesitás memorizarlo.
¿Por qué es útil?
Te ayuda a evitar errores de instalación y saber comprobar que tu computadora está lista.
¿Qué vas a aprender?
Practicarás reconocer la función de cada herramienta y verificarla con una prueba pequeña. Cada término nuevo se explica antes de usarlo.
Tu primera acción
No instalés ni ejecutes nada todavía. Primero lee las palabras esenciales y observa el ejemplo pequeño. Después identificarás qué dato entra, qué instrucción trabaja y qué resultado aparece.
Cómo usar esta lección
Avanza una parte a la vez
Leé las palabras nuevas y el ejemplo pequeño.
Seguí los pasos sin cambiar varias cosas a la vez.
Respondé las preguntas y usa pistas cuando lo necesites.
Marcá el checklist y toma una pausa antes de continuar.
Aprende las palabras esenciales
Leé definiciones cortas y explica cada palabra con un ejemplo propio.
Mirá un ejemplo pequeño
Comprende primero una comprobación sencilla y después sigue las instrucciones.
Ejemplo pequeño antes de continuar
Comprobar Python en macOS
Leé una línea a la vez. No memoricés el comando: identificá qué comprueba.
python3 --version
which python3- ¿Qué escribís o seleccionás?
- ¿Qué herramienta realiza el trabajo?
- ¿Qué resultado confirma que funcionó?
🧭 Instrucciones paso a paso
Abrí Terminal
Presioná Command + Space, escribe Terminal y presioná Enter.
Identificá el procesador
Escribí uname -m y presioná Enter.
arm64 en Apple silicon o x86_64 en Intel.Comprobá si Python ya existe
Ejecutá python3 --version, después which python3.
Instalá Python desde la fuente oficial
Abrí el navegador, entra en la página oficial de descargas de Python para macOS, descarga el instalador estable y abre el archivo .pkg. Pulsa Continue, acepta la licencia y completa Install.
Reinicia la terminal y verifica
Cerrá Terminal por completo, vuelve a abrirla y ejecuta python3 --version y python3 -m pip --version.
Instalá Visual Studio Code
Descargá VS Code para macOS, abre el archivo, arrastra Visual Studio Code a Applications y abre la aplicación. Si macOS pregunta, confirma que deseas abrirla.
Activá el comando code
En VS Code presiona Command + Shift + P. Buscá Shell Command: Install code command in PATH y selecciónalo. Reinicia Terminal.
code --version muestra una versión.Creá y ejecuta tu primer archivo
En Terminal entra a la carpeta del curso con cd ~/Documents/python-ai-course. Ejecutá code .. En VS Code crea hello.py, escribe print("Python funciona correctamente"), guarda y ejecuta python3 hello.py.
⌨️ Comandos y archivos
Escribí los comandos uno por uno. Presioná Enter después de cada línea.
uname -m
python3 --version
which python3
python3 -m pip --version
code --versioncd ~/Documents/python-ai-course
python3 hello.py🛠️ Solución de problemas
| Lo que ves | Qué hacer |
|---|---|
| zsh: command not found: python | En macOS prueba python3 --version. Fuera de un entorno virtual es normal que python no exista. |
| zsh: command not found: python3 | Cerrá y abre Terminal. Si continúa, instala Python desde python.org y vuelve a verificar. |
| zsh: command not found: code | Ejecutá “Shell Command: Install code command in PATH” desde Command Palette y reinicia Terminal. |
| No such file or directory: hello.py | Ejecutá pwd y ls. Tenés que estar en la carpeta donde guardaste hello.py. |
🤖 Usa Cursor como tutor
Estoy siguiendo la lección 00-02 para una persona principiante.
Explica el siguiente paso sin ejecutar comandos por mí.
Indica qué debería ver y cómo comprobarlo.
No modifiques archivos ni configuración sin mi aprobación.Aprende las palabras antes de usarlas
🧠 Conceptos explicados desde cero
No necesitás memorizar estas palabras. Comprende qué hace cada una y dónde la verás.
instalar
Qué significa: Copiar y configurar un programa para que macOS pueda utilizarlo.
Para qué sirve: Preparar Python y VS Code.
Ejemplo pequeño: Abrir el instalador y seguir sus pasos.
Confusión frecuente: Descargar un archivo no significa que ya esté instalado.
PATH
Qué significa: Lista de carpetas donde la terminal busca programas.
Para qué sirve: Encontrar comandos como python3 y code.
Ejemplo pequeño: which python3
Confusión frecuente: No es una carpeta única; es una lista de ubicaciones.
python3
Qué significa: Comando habitual para ejecutar Python 3 en macOS.
Para qué sirve: Comprobar la versión y ejecutar scripts.
Ejemplo pequeño: python3 --version
Confusión frecuente: El comando python puede no existir fuera de un entorno virtual.
Homebrew
Qué significa: Administrador de paquetes opcional para macOS.
Para qué sirve: Instalar herramientas desde Terminal.
Ejemplo pequeño: brew install python
Confusión frecuente: No debe mezclarse con otra ruta de instalación sin necesidad.
Primero entiende el ejemplo
🖼️ Explicación ilustrada: entrada → proceso → resultado
Instalar Python es como instalar un lector para un tipo especial de documento.
Situación
Tu Mac tiene un archivo Python, pero todavía no sabe con qué intérprete ejecutarlo.
Entrada
Escribís python3 --version en Terminal.
Proceso
macOS busca el ejecutable llamado python3 en las rutas configuradas.
Resultado
Aparece una versión de Python o un mensaje indicando que no está instalado.
Ejemplo antes y después
Antes de instalar: el comando puede no existir.
Después de instalar: el comando muestra la versión y puede ejecutar archivos.
¿Cómo usarás este ejemplo en el mini proyecto?
Ahora practicarás con un mini proyecto. Primero observarás el ejemplo, después cambiarás una sola parte y finalmente explicarás el resultado.
Regla: cambia una sola parte, ejecuta de nuevo y explica qué diferencia observaste. No necesitás reconstruir el proyecto completo.
Practica con un mini proyecto
Hacé un cambio pequeño, ejecuta el código y observa qué cambió.
Practica paso a paso
🧩 Mini proyecto guiado: Instalar Python y VS Code en macOS
Completá estos ejercicios pequeños antes del desafío. Podés equivocarte: el sistema te explicará qué repasar y te dará una pista.
Reconoce una palabra nueva
En esta lección aparece programa. ¿Cuál es la mejor forma de aprenderlo?
Pista: aprender programación no consiste en memorizar palabras; consiste en relacionarlas con una acción y un resultado.
Hacé un cambio seguro
Querés practicar con el código de Instalar Python y VS Code en macOS. ¿Qué cambio es mejor para comenzar?
Pista: cambia una sola cosa para poder relacionar ese cambio con el resultado.
Comprobá lo que ocurrió
Después de modificar un dato, ¿qué tenés que hacer para saber si aprendiste correctamente?
Pista: un cambio solo se entiende cuando podés observar su efecto.
Tu mini proyecto
Tarea: abre el editor del navegador o el archivo completo. Cambiá un solo dato visible, ejecútalo y observa qué parte del resultado cambió.
Pista: usa un cambio fácil de reconocer, como un nombre, número, etiqueta o texto de ejemplo.
Progreso del mini proyecto
Completá los cuatro pasos.
🎉 ¡Mini proyecto completado!
Hiciste algo importante: comprendiste un concepto, cambiaste una sola parte, ejecutaste el código y explicaste el resultado. Esa es una práctica real de programación.
Aprende comprobando
🧪 Comprobaciones programando
Ejecutá un caso controlado y deja que el código compruebe condiciones importantes.
# macOS — Terminal
python3 --version
which python3
code --version
git --version
# Windows — PowerShell
# python --version
# where python
# code --version
# git --versionDespués de ejecutarlo
- ¿Qué condición comprueba cada
assert? - ¿Qué cambio hace fallar la comprobación?
- ¿El mensaje explica qué tenés que corregir?
- ¿Podés agregar otro caso?
Cerrá la lección
Comprobá que la herramienta funciona, marca el checklist y decide si continuar.
Comprobá lo que entendiste
Respondé una pregunta a la vez. Podés usar pistas y volver a intentarlo.
Evaluación online
❓ Comprueba lo que entendiste
Respondé sobre Instalar Python y VS Code en macOS. Verás una explicación completa y podrás intentarlo nuevamente.
Pregunta 1 de 5 · Selección
¿Cuál describe mejor la entrada principal?
Buscá lo que la persona proporciona antes de que el programa trabaje.
La entrada es el comando, selección o dato que proporciona la persona. Existe antes de la transformación.
Pregunta 2 de 5 · Selección
¿Qué describe mejor el procesamiento?
Elegí la opción que calcula, valida, organiza o transforma.
El procesamiento ocurre cuando la herramienta busca, configura o ejecuta el programa. Convierte la entrada en un resultado.
Pregunta 3 de 5 · Selección
¿Qué error esperado debería manejarse?
Un programa confiable anticipa problemas razonables.
Debe manejar comando inexistente, intérprete incorrecto o ruta sin configurar. Anticiparlo permite mostrar una solución clara.
Pregunta 4 de 5 · Respuesta breve
Menciona un caso, el resultado esperado y cómo compararías.
Una respuesta completa propone un caso conocido, ejecuta el código, define el resultado esperado y compara el resultado real. Puede usar assert o una prueba automatizada.
Pregunta 5 de 5 · Respuesta breve
Piensa en evidencia visible, documentación, pruebas o facilidad de uso.
No existe una única mejora. Una respuesta sólida propone al menos dos acciones verificables: pruebas, manejo de errores, README, captura o demo, decisiones documentadas o una interfaz clara.
Resultado de la evaluación
Completá las cinco preguntas.
✅ Checklist mejorado
Tu progreso se guarda en este navegador. Una lección se completa cuando todas las comprobaciones están marcadas.
Preparación
Marcá cada punto solamente después de comprobarlo.
Python
Marcá cada punto solamente después de comprobarlo.
VS Code
Marcá cada punto solamente después de comprobarlo.
Probá final
Marcá cada punto solamente después de comprobarlo.
Cómo podrás mejorar este proyecto
🚀 Mejoras futuras y dónde las aprenderás
No son obligatorias ahora. Son mejoras que aplicarás cuando aprendas las herramientas correspondientes.
Separar la configuración del código
Qué mejora: Evita editar el programa cuando cambia una ruta, clave o preferencia.
Dónde lo aprenderás: en la lección «Protege tokens con .env», del nivel APIs y servicios externos.
Añadir pruebas automatizadas
Qué mejora: Comprueba que una modificación no rompa lo existente.
Dónde lo aprenderás: en la lección «Escribe pruebas unitarias», del nivel Testing y despliegue.
Registrar la ejecución
Qué mejora: Ayuda a entender fallos sin imprimir datos sensibles.
Dónde lo aprenderás: en la lección «Configura observabilidad», del nivel Testing y despliegue.
Mejorar mensajes y validación
Qué mejora: Explica qué dato falta y cómo corregirlo.
Dónde lo aprenderás: en la lección «Entrada de datos segura», del nivel Fundamentos de Python.
Documentar decisiones y limitaciones
Qué mejora: Permite que otra persona comprenda y evalúe el proyecto.
Dónde lo aprenderás: en la lección «Construye casos de estudio», del nivel Portafolio profesional.
Crear una demostración
Qué mejora: Muestra el problema, funcionamiento y evidencia.
Dónde lo aprenderás: en la lección «Crea un índice HTML», del nivel Portafolio profesional.