C++ const 사용 규칙¶

상태: 채택 · 적용 범위: C++의 읽기 전용 의도 표현 · 예제: C++11 이상 · 개정일: 2026-10-16

const는 변경하면 안 되는 값을 명시하기 위해 사용한다. 현재 코드에서 재대입하지 않는다는 사실만으로 지역 변수에 일괄 적용하지 않는다.

핵심 규칙¶

대상	적용 기준	강도
지역 변수	의미상 읽기 전용임이 명확할 때 적용	필수
계산용 작업 변수	갱신·누적할 값은 일반 변수로 선언	권장
참조·포인터 입력	대상 변경이 필요 없으면 `const T&`·`const T*`	권장
값으로 받는 매개변수	함수 선언에 최상위 `const`를 붙이지 않음	권장
조회 멤버 함수	객체의 논리적 상태를 변경하지 않으면 후행 `const`	권장
컴파일 시점의 고정값	상수 표현식으로 사용할 값은 `constexpr`	권장

지역 변수: 읽기 전용 의도가 명확할 때¶

기준값·스냅샷처럼 변경하면 의미가 훼손되는 값에 사용한다. 미래 요구가 아닌 현재 설계로 판단한다.

int ApplyDamageAndGetLoss(
    int& health,
    int damage)
{
    // 비교 기준으로 보존해야 하는 이전 상태의 복사본
    const int originalHealth = health;
    health -= damage;
    return originalHealth - health;
}

보정·누적할 작업 변수는 일반 변수로 둔다. 재대입이 없다는 사실만으로 const를 강제하지 않는다.

const를 위한 변수·로직 분할은 피한다. 갱신이 필요해지면 제거할 수 있으며 이전 값을 보존해야 할 때만 작업 변수를 추가한다.

매개변수와 멤버 함수¶

전달 형태는 함수 규칙에서 선택하고 이 절의 const 기준을 적용한다.

#include <string>

bool HasName(const std::string& name)
{
    return !name.empty();
}

void SetHealth(int health); // 값 전달: 선언에 const를 붙이지 않는다.

값 매개변수의 최상위 const는 호출자를 보호하지 않는다. 정의 내부 적용은 지역 변수의 읽기 전용 의도로 판단한다.

class Player
{
public:
    int GetHealth() const
    {
        return mHealth;
    }

private:
    int mHealth = 100;
};

상태를 바꾸는 포인터·참조를 반환하는 함수도 단순 조회가 아니다. 후행 const는 지역 변수의 적용 기준과 구분하며 스레드 안전성·깊은 불변성을 보장하지 않는다.

포인터의 대상과 포인터 자체¶

표기	해당 포인터를 통한 대상 변경	포인터 재지정
`const int* value`	불가	가능
`int* const value`	가능	불가
`const int* const value`	불가	불가

const T를 기본 표기로 쓴다. const T&는 해당 참조를 통한 수정만 제한하므로 다른 경로의 변경까지 막는 스냅샷이 아니다.

const와 constexpr¶

const는 초기화 이후의 수정을 제한하며 실행 중 구한 값에도 사용할 수 있다. constexpr 변수는 컴파일 시점에 평가할 수 있는 초기값이 필요하다.

int GetRetryLimit()
{
    constexpr int retryLimit = 3;
    return retryLimit;
}

컴파일 시점에 정하는 고정값에는 constexpr를 권장한다. 이름은 상수 명명 규칙을 따른다.

예외와 주의사항¶

이동해서 전달하거나 반환할 객체에는 기계적으로 const를 붙이지 않는다. 일반적인 이동 생성은 비상수 객체를 요구하므로 복사가 발생하거나 컴파일되지 않을 수 있다.
const 멤버 변수를 모든 클래스에 일괄 도입하지 않는다. 복사·이동 대입 가능성 등 타입 설계에 영향을 주므로 별도로 판단한다.
필요한 갱신을 허용하려고 const_cast로 제한을 우회하지 않는다. 선언 또는 인터페이스의 의도를 먼저 바로잡는다.
외부 API의 지정된 시그니처는 유지한다. 스마트 포인터 전달은 소유권·수명 규칙을 따른다. 캐시를 위한 mutable 사용은 후속 설계 주제로 다룬다.

근거와 출처¶

기존 컨벤션（로컬 참고 자료）의 읽기 전용 매개변수·멤버 함수 원칙을 참고했다. const T&는 모든 입력 타입의 기본값으로 확대하지 않고 값 전달과 구분했다.

Google은 지역 const에 중립적이고 Core Guidelines는 변경하지 않는 객체에 권장한다. 이 문서는 사용자 선택으로 의미상 읽기 전용인 지역 변수에 적용한다.

출처 확인일: 2026-09-12.

채택일: 2026-09-12. 명시된 적용 범위 안에서 채택하며, 후속 정리 대상은 제외한다.

변경 기록¶

2026-10-16: 반복 설명·중복 예시·배경을 줄여 핵심 규칙과 예시 중심으로 정리했다. 규칙 강도·예외·버전과 채택·초안·미결정 상태는 유지했다.
2026-10-06: 상수 명명의 선언 범위 기준 개정에 맞춰 함수 내부의 constexpr 예제를 retryLimit으로 작성했다. 상수 명명의 상세 정의는 명명 문서에서 관리한다.