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 • Equip 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?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat