Ключевое слово global в Python

Обновлено:

Мы уже знаем, что переменные, созданные вне функций, находятся в глобальной области видимости.

Например:

number = 100


def show_number():
    print(number)


show_number()

Результат:

100

Функция может читать глобальную переменную без каких-либо дополнительных ключевых слов.


1. Чтение глобальной переменной

language = 'Python'


def show_language():
    print(language)


show_language()

Результат:

Python

Переменная:

language

находится в глобальной области видимости.

Функция не создаёт локальную переменную с таким именем и поэтому находит глобальную.


2. Проблема появляется при присваивании

Рассмотрим:

count = 10


def increase_count():
    count = count + 1


increase_count()

Такой код приведёт к:

UnboundLocalError

Почему?

Когда Python видит внутри функции присваивание:

count = ...

он считает count локальной переменной этой функции.

Поэтому выражение:

count + 1

пытается сначала получить значение локальной count.

Но значение ей ещё не было присвоено.


3. Локальная и глобальная переменные могут иметь одинаковое имя

Например:

number = 100


def change_number():
    number = 500
    print(number)


change_number()

print(number)

Результат:

500
100

Внутри функции была создана новая локальная переменная:

number = 500

Она не изменила глобальную:

number = 100

Ключевое слово global

4. Изменяем глобальную переменную

Если внутри функции нужно присваивать значение именно глобальной переменной, используется:

global

Например:

count = 10


def increase_count():
    global count

    count += 1


increase_count()

print(count)

Результат:

11

Строка:

global count

говорит Python:

В этой функции имя count относится к переменной из глобальной области видимости.

Поэтому:

count += 1

изменяет именно глобальную переменную.


5. Несколько вызовов функции

count = 0


def increase_count():
    global count

    count += 1


increase_count()
increase_count()
increase_count()

print(count)

Результат:

3

Каждый вызов работает с одной и той же глобальной переменной:

count

6. Можно полностью заменить значение

status = 'offline'


def connect():
    global status

    status = 'online'


connect()

print(status)

Результат:

online

Без:

global status

внутри функции была бы создана отдельная локальная переменная.


7. global нужен не для чтения

Так писать можно:

price = 100


def show_price():
    print(price)

Здесь:

global price

не требуется.

global нужен, когда внутри функции мы собираемся присваивать или удалять имя в глобальной области видимости.

Например:

price = 100


def change_price():
    global price

    price = 150

Изменяемый объект и global

8. Изменение объекта — не то же самое, что переприсваивание переменной

Рассмотрим глобальный список:

numbers = [
    10,
    20,
]

Функция может изменить сам список:

def add_number():
    numbers.append(30)


add_number()

print(numbers)

Результат:

[10, 20, 30]

Здесь:

global numbers

не понадобился.

Почему?

Потому что мы не выполняли:

numbers = ...

Мы получили существующий объект и изменили его методом:

append()

9. Если переприсваиваем список — global уже нужен

numbers = [
    10,
    20,
]


def replace_numbers():
    global numbers

    numbers = [
        100,
        200,
    ]


replace_numbers()

print(numbers)

Результат:

[100, 200]

Здесь мы уже не изменяем старый список.

Мы выполняем новое присваивание:

numbers = [...]

Поэтому нужен:

global numbers

10. Сравним два случая

Изменение существующего объекта:

numbers.append(30)

global не нужен.

Переприсваивание имени:

numbers = [
    100,
    200,
]

global нужен, если необходимо изменить именно глобальную переменную.


Несколько глобальных имён

11. Можно указать несколько переменных

score = 0
level = 1


def reset_game():
    global score, level

    score = 0
    level = 1

Оба имени внутри функции будут относиться к глобальным переменным.


Удаление глобальной переменной

12. del вместе с global

Если требуется удалить глобальное имя из функции:

message = 'Hello'


def remove_message():
    global message

    del message


remove_message()

После этого обращение:

print(message)

приведёт к:

NameError

Где пишется global

13. До присваивания переменной

Обычно:

value = 10


def change_value():
    global value

    value = 20

Сначала сообщаем Python, что имя глобальное:

global value

а затем используем его для присваивания.

Нельзя сначала присвоить этому имени локальное значение, а потом объявить его global в той же функции.


Когда global стоит использовать

global иногда полезен, когда функция действительно должна изменить состояние, находящееся на уровне модуля.

Например, простой счётчик:

request_count = 0


def register_request():
    global request_count

    request_count += 1

Для небольших учебных программ такой подход вполне понятен.


Когда лучше не злоупотреблять global

Большое количество глобальных изменяемых переменных усложняет программу.

Например, функция:

def calculate():
    global total
    global discount
    global tax
    global result

    ...

зависит от большого количества внешнего состояния.

Такой код сложнее:

  • читать;
  • проверять;
  • изменять;
  • повторно использовать.

Часто понятнее передавать данные через параметры и возвращать результат через:

return

Например, вместо:

total = 100


def add_tax():
    global total

    total *= 1.2

можно написать:

def add_tax(total):
    return total * 1.2


total = add_tax(100)

Оба подхода возможны, но второй обычно создаёт меньше скрытых зависимостей.


Главное по теме

Глобальная переменная создаётся вне функции:

number = 100

Функция может читать её без global:

def show_number():
    print(number)

Если внутри функции написать:

number = 200

без global, будет создано локальное имя.

Чтобы присваивание относилось к глобальной переменной:

number = 100


def change_number():
    global number

    number = 200

global необходим прежде всего при:

name = ...
name += ...
del name

если эти действия должны работать именно с глобальным именем.


Если функция только изменяет уже существующий изменяемый объект:

numbers.append(10)

global не требуется, потому что само имя:

numbers

не переприсваивается.


Основная идея:

читать глобальную переменную
→ global обычно не нужен

переприсваивать глобальную переменную
→ нужен global

Использовать global можно, но в больших программах лучше не строить слишком много логики вокруг изменяемого глобального состояния.