Global y nonlocal en Python

Guía clara sobre global y nonlocal en Python: diferencias, ejemplos y buenas prácticas para evitar UnboundLocalError en código de proyectos a medida.

19 ago 2025 • 3 min de lectura • Equipo Q2BSTUDIO

Inteligencia-Artificial-

Global vs nonlocal en Python: explicación clara y ejemplos prácticos

En Python existen dos declaraciones que permiten a funciones internas acceder o modificar variables definidas fuera de su ámbito local: global y nonlocal. Entender la diferencia es clave para evitar errores como UnboundLocalError y para diseñar código limpio en proyectos de aplicaciones a medida y software a medida.

Uso de global: la declaración global indica que una variable referenciada dentro de una función remite a la variable global del módulo. Ejemplo simplificado en una sola línea para ilustrar la idea: num = 2; def first(): num = 4; def second(): num = 6; def third(): global num; print(num) # imprime 2. Si además se modifica la variable con global num; num += 10; print(num) entonces la variable global se actualiza y pasa a valer 12.

Uso de nonlocal: nonlocal se emplea en funciones anidadas para referirse a una variable definida en la función exterior inmediata, no en el ámbito global. Ejemplo compacto: num = 2; def first(): num = 4; def second(): num = 6; def third(): nonlocal num; print(num) # imprime 6. Si en third se hace nonlocal num; num += 10; print(num) entonces la variable del ámbito exterior inmediato se modifica y pasa a valer 16 dentro de ese contexto.

Diferencia clave: global apunta al ámbito del módulo, nonlocal apunta al ámbito de una función exterior inmediata. Sin declarar nonlocal o global, una función interior puede leer variables de ámbitos exteriores, pero si intenta asignarles o incrementarlas sin la declaración adecuada Python asume que son locales y se produce UnboundLocalError al intentar usar la variable antes de inicializarla. Ejemplo reducido: intentar hacer num += 5 dentro de una función interior sin declarar nonlocal provoca UnboundLocalError.

No mezclar global y nonlocal en la misma función: Python prohíbe declarar una misma variable como nonlocal y global en la misma función anidada y lanzará un error de sintaxis. Diseñar el alcance de las variables con claridad evita este tipo de conflictos.

Buenas prácticas: evitar abusar de variables globales; preferir pasar parámetros, devolver resultados, usar objetos y atributos de clase o emplear closures con nonlocal cuando convenga. Para proyectos profesionales de software a medida y aplicaciones a medida estas prácticas facilitan mantenibilidad, pruebas y escalabilidad, especialmente cuando se integran soluciones de inteligencia artificial o agentes IA.

Cómo podemos ayudarte desde Q2BSTUDIO: en Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida. Ofrecemos integración de inteligencia artificial y soluciones de ia para empresas, implementación de agentes IA, consultoría en ciberseguridad, servicios cloud aws y azure y servicios de inteligencia de negocio incluyendo power bi para visualización y análisis. Nuestros equipos ayudan a definir la arquitectura correcta, aplicar buenas prácticas de programación y evitar problemas de alcance de variables al diseñar sistemas complejos con componentes de IA, pipelines de datos y microservicios.

Servicios destacados de Q2BSTUDIO: aplicaciones a medida, desarrollo de software a medida, proyectos de inteligencia artificial, agentes IA personalizados, consultoría en ciberseguridad, migración y gestión en servicios cloud aws y azure, servicios inteligencia de negocio y dashboards con power bi. Combinamos experiencia técnica con prácticas de seguridad y escalabilidad para que tu proyecto funcione en producción.

Si necesitas ayuda para diseñar código fiable que integre inteligencia artificial, agentes IA o soluciones en la nube, contacta con Q2BSTUDIO y te acompañamos desde el prototipo hasta la entrega en producción con enfoque en ciberseguridad y rendimiento.

¿UNA PAUSA?

Juega un momento antes de irte

NUESTROS SERVICIOS

Cómo podemos ayudarte

Inteligencia artificial

Agentes de IA, chatbots y asistentes inteligentes que automatizan tareas y atienden a tus clientes 24/7 para mejorar la eficiencia de tu negocio.

Más info

Desarrollo de software

Aplicaciones web, móviles y de escritorio, intranets, e-commerce, SaaS y plataformas de gestión diseñadas para las necesidades concretas de tu empresa.

Más info

Servicios cloud

Migración, infraestructura, hosting gestionado, alta disponibilidad y seguridad en Microsoft Azure y Amazon Web Services para que tu negocio escale sin límites.

Más info

Ciberseguridad y pentesting

Auditorías de seguridad, test de intrusión (pentesting) y protección de aplicaciones, datos e infraestructura on-premise y cloud, con hacking ético y cumplimiento normativo.

Más info

Business Intelligence

Cuadros de mando y análisis de datos con Power BI: integramos tus fuentes, diseñamos dashboards y KPIs y convertimos tus datos en decisiones.

Más info

Automatización de procesos

Automatizamos tareas repetitivas y conectamos tus aplicaciones con n8n, Power Automate, Make y RPA, eliminando trabajo manual y aumentando la productividad.

Más info

Formación para empresas

Formamos a tus equipos en tecnología con criterio: desarrollo web, bases de datos, Git, buenas prácticas y seguridad, automatización con n8n, inteligencia artificial para empresas y creación de soluciones de IA con Azure AI Foundry.

Más info

Auditoría de código

Auditamos el código que creas tú, tu equipo o una IA: te decimos qué está bien y qué mejorar, lo securizamos y lo dejamos listo para producción, web o app.

Más info

Generación de imágenes con IA

Creamos por ti las imágenes que necesita tu negocio con inteligencia artificial: producto, redes, publicidad, ilustración y avatares. Tú nos dices qué quieres y te lo entregamos listo para usar.

Más info

Generación de vídeos con IA

Creamos por ti vídeos con inteligencia artificial: promocionales, para redes, presentadores virtuales, doblaje y animaciones. Nos cuentas la idea y te lo entregamos montado y listo para publicar.

Más info

Avatares conversacionales con IA

Creamos avatares conversacionales con IA —humanos digitales con cara y voz— que atienden a tus clientes y equipos con el conocimiento de tu empresa, en tu web, monitores interactivos, WhatsApp o Teams.

Más info

Marketing Online e IA

Google Ads, Meta Ads, LinkedIn Ads y posicionamiento en motores de IA (GEO/AEO): captamos clientes y hacemos que tu marca aparezca donde te buscan, también en ChatGPT, Gemini y Perplexity.

Más info

¿Tienes un proyecto en mente?

Cuéntanos tu visión y la convertimos en una solución de software. Sea cual sea el alcance, hacemos realidad tu idea.

Live Chat