Files

T

koriweb 5ba5a55c78 feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

2026-05-08 19:52:07 +09:00

5.1 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

에일리어싱 (Aliasing)

📌 한 줄 통찰 (The Karpathy Summary)

에일리어싱(Aliasing)은 프로그래밍에서 기존 데이터 타입에 새로운 이름을 부여하거나(타입 에일리어싱), 동일한 데이터를 여러 참조 변수가 가리키게 되는 현상(참조 에일리어싱)을 의미합니다 [1, 2]. TypeScript에서 타입 에일리어싱은 기존 타입과 상호 호환되는 서술적인 이름표 역할을 하며, 참조 에일리어싱은 [[readonly|readonly]] 데이터가 가변(mutable) 참조로 전달될 때 의도치 않은 데이터 변형(Mutation)을 일으키는 주요 원인이 되기도 합니다 [1-3].

📖 구조화된 지식 (Synthesized Content)

타입 에일리어싱 (Type Aliasing): TypeScript에서 type 키워드를 사용하여 기존 타입에 새로운 이름을 부여하는 것을 타입 에일리어스라고 부릅니다 [4]. 예를 들어 type Percentage = number와 같이 선언할 수 있으나, 이는 단순히 기존 타입에 새로운 이름을 부여하는 서술적인(descriptive) 역할만 할 뿐, 기능적으로 완전히 독립된 새로운 타입을 생성하는 것은 아닙니다(기존 타입과 상호 교환 가능) [1]. 주로 원시 타입(primitives), 유니언(unions), 튜플(tuples) 등 인터페이스로 표현하기 힘든 복잡한 타입 구성을 명명할 때 사용됩니다 [4, 5].
데이터 참조 에일리어싱과 readonly의 함정: TypeScript에서 readonly 수식어를 사용할 때 개발자들이 가장 자주 겪는 함정은 에일리어싱(Aliasing)을 통한 데이터 변형입니다 [2]. readonly는 오직 해당 readonly 참조를 통한 직접적인 접근 및 수정만을 방지합니다 [6].
타입 호환성으로 인한 변형 위험: 만약 readonly로 선언된 배열이나 객체를 가변(mutable) 매개변수를 기대하는 함수에 전달할 경우, TypeScript는 타입 호환성(type compatibility)의 이유로 이를 허용하게 됩니다 [2]. 이렇게 에일리어싱이 발생하면 해당 함수 내부에서 가변 참조를 통해 원본 "readonly" 데이터를 수정할 수 있는 취약점이 발생합니다 [2, 3]. 이를 방지하기 위해서는 함수 시그니처를 신중하게 설계하여 readonly 매개변수를 받도록 강제하거나, 데이터를 복사하여 전달해야 합니다 [3].

⚠️ 모순 및 업데이트 (Contradictions & Updates)

과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
정책 변화: Programming & Language 분야의 자동 자산화 수행.

🔗 지식 연결 (Graph)

Related Topics: Type Alias (타입 별칭), Readonly 유틸리티 타입, Opaque Types (불투명 타입)
Projects/Contexts: TypeScript의 불변성(Immutability) 관리, 인터페이스와 타입 별칭 비교(Interface vs Type)
Contradictions/Notes: TypeScript의 readonly는 컴파일 타임에 불변성을 제공하는 강력한 도구이지만, 에일리어싱을 통해 데이터가 가변 매개변수로 전달될 경우에는 컴파일러가 이를 잡아내지 못하여 데이터가 수정될 수 있다는(얕은 불변성) 근본적인 한계를 지닙니다 [2, 6].

Last updated: 2026-04-18

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

(TODO)

언제 쓰면 안 되는가:

(TODO)

🧪 검증 상태 (Validation)

정보 상태: needs_review
출처 신뢰도: A
검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
처리 방식: UPDATE (자동 정규화)
처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

5.1 KiB Raw Blame History