---

# 📌 서론 – 왜 Lua 5.5가 주목받고 있나요?

Lua는 가볍고 임베디드 환경에 최적화된 스크립트 언어로, 게임 엔진부터 IoT 디바이스까지 폭넓게 사용됩니다. 2024년 10월, Lua 5.5가 정식 릴리즈되면서 가장 큰 화두는 전역 변수 선언과 가비지 컬렉션 개선이었습니다. 기존 버전에서는 전역 변수를 선언 없이 바로 사용하면 실수로 오타가 발생하거나 메모리 누수가 일어나기 쉬웠습니다. 또한, 가비지 컬렉션이 비동기적으로 동작하면서 일시적인 프레임 드롭 현상이 보고되곤 했죠.

이번 글에서는 초보자도 이해하기 쉽도록 Lua 5.5의 핵심 변화와 실제 적용 방법을 단계별로 살펴보겠습니다.

SEO 키워드: Lua 5.5, 전역 변수 선언, 가비지 컬렉션

---

# 1️⃣ Lua 5.5란? – 기본적인 변화 한눈에

| 항목 | Lua 5.4 이전 | Lua 5.5 |

|------|--------------|----------|

| 전역 변수 | 선언 없이 바로 사용 | global 키워드로 명시적 선언 |

| 가비지 컬렉션 | 동기식 + 스톱‑더‑월드 | 단계적(Incremental) + 세분화된 트리거 |

| 메타테이블 | 기존 방식 유지 | __newindex 개선으로 안전성 향상 |

| 모듈 시스템 | require 기반 | module 선언 지원 (선택적) |

• 전역 변수 선언: global 키워드를 사용해 전역 스코프를 명시적으로 지정합니다.

• 가비지 컬렉션 개선: 메모리 해제 시점이 더 세밀해져 프레임 레이트가 안정됩니다.

이러한 변화는 코드 가독성과 성능을 동시에 끌어올려, 초보자도 안심하고 Lua를 배울 수 있게 합니다.

---

# 2️⃣ 전역 변수 선언 – 실수 없는 코딩을 위한 새로운 문법

# 2.1 왜 전역 변수를 선언해야 할까?

전역 변수를 무분별하게 만들면 다음과 같은 위험이 있습니다.

1. 오타에 의한 버그 – score와 socre를 구분 못함.

2. 네임스페이스 충돌 – 다른 모듈에서 동일 이름 사용 시 예기치 않은 동작.

3. 디버깅 어려움 – 어디서 변수가 생성됐는지 추적이 복잡.

# 2.2 global 키워드 사용법

lua

-- 기존 방식 (오류 발생 가능)

counter = 0

-- Lua 5.5 권장 방식

global counter = 0

• global 뒤에 변수명을 적고, 초기값을 할당하면 전역 스코프에 안전하게 등록됩니다.

• 선언되지 않은 전역 변수를 접근하려 하면 런타임 오류가 발생해, 개발 단계에서 바로 문제를 발견할 수 있습니다.

# 2.3 실제 예시

lua

-- moduleA.lua

global playerScore = 0

function addScore(val)

    playerScore = playerScore + val

end

lua

-- moduleB.lua

-- 선언 없이 접근하면 오류 발생

print(playerScore)   -- → nil (오류 발생)

위와 같이 global 선언을 통해 명시적 전역 관리가 가능해집니다.

---

# 3️⃣ 가비지 컬렉션 개선 – 메모리 관리가 더 똑똑해졌다

# 3.1 기존 가비지 컬렉션의 한계

• Stop‑the‑World 방식: 컬렉션이 진행되는 동안 전체 스레드가 멈춰 프레임 드롭이 일어났습니다.

• 대량 메모리 해제 시 일시적인 메모리 스파이크가 발생했습니다.

# 3.2 새로운 단계적 컬렉션

Lua 5.5는 Incremental GC(증분 가비지 컬렉션) 방식을 도입했습니다.

1. 마크 단계 – 살아있는 객체를 표시.

2. 스윕 단계 – 표시되지 않은 객체를 해제.

3. 청소 단계 – 메모리 풀을 정리하고 재활용.

각 단계는 짧은 시간에 실행돼, 게임 루프나 실시간 애플리케이션에서도 부드러운 프레임을 유지합니다.

# 3.3 설정 옵션

lua

-- 기본값 (자동)

collectgarbage('incremental')

-- 수동 조정 (필요 시)

collectgarbage('setpause', 100)   -- 컬렉션 주기

collectgarbage('setstepmul', 200) -- 단계당 작업량

초보자라면 기본 설정을 그대로 사용해도 충분하지만, 성능 튜닝이 필요하면 위 옵션을 조절해 보세요.

---

# 4️⃣ 실제 적용 예제 – 간단한 게임 루프에 적용해 보기

lua

-- main.lua

global health = 100

global enemies = {}

function spawnEnemy()

    local e = {hp = 30}

    table.insert(enemies, e)

end

function update(dt)

    -- 적이 사라질 때마다 가비지 컬렉션이 자동으로 작동

    for i = #enemies, 1, -1 do

        local e = enemies[i]

        e.hp = e.hp - dt * 10

        if e.hp <= 0 then

            table.remove(enemies, i)   -- 메모리 해제 대상

        end

    end

end

-- 게임 루프 (예시)

while true do

    local dt = 0.016   -- 60FPS 가정

    update(dt)

    collectgarbage('step', 1)   -- 단계적 컬렉션 한 번 실행

end

• global 선언으로 health와 enemies를 명확히 전역에 배치했습니다.

• collectgarbage('step', 1)을 루프마다 호출해 증분 컬렉션을 진행, 프레임 드롭 없이 메모리를 정리합니다.

---

# 5️⃣ 업그레이드 시 고려해야 할 점

| 체크리스트 | 설명 |

|------------|------|

| 전역 변수 선언 검토 | 기존 코드에 global 선언이 없는 변수가 있다면 오류가 발생합니다. 자동 변환 스크립트를 활용해 일괄 수정하세요. |

| GC 설정 테스트 | 프로젝트 규모에 따라 setpause와 setstepmul 값을 조정해 최적의 성능을 찾습니다. |

| 호환성 확인 | C API를 직접 호출하는 경우, luaL_newstate 이후 lua_setglobal 사용을 권장합니다. |

| 문서 업데이트 | 팀 위키나 주석에 global 사용 규칙을 명시해 일관성을 유지합니다. |

---

# 🎯 결론 – 지금 바로 Lua 5.5를 체험해 보세요!

Lua 5.5는 전역 변수 선언이라는 안전 장치를 제공하고, 가비지 컬렉션을 단계적으로 개선해 실시간 애플리케이션에서도 부드러운 실행을 보장합니다. 초보자라면 global 키워드와 기본 GC 설정만으로도 큰 차이를 느낄 수 있을 것입니다.

다음 단계

1. 공식 사이트에서 Lua 5.5 바이너리를 다운로드

2. 기존 프로젝트에 global 선언을 적용하고 테스트 실행

3. collectgarbage 옵션을 조정해 성능을 직접 체험

여러분의 프로젝트에 Lua 5.5를 도입해 코드 안정성과 퍼포먼스를 동시에 향상시켜 보세요. 궁금한 점이나 적용 사례가 있다면 댓글로 공유해 주세요! 🚀