Summary#

React UI 상태의 배열·객체를 갱신할 때는 기존 상태를 직접 변경하지 말고 변경된 값이 반영된 새 배열·객체를 만들어 상태 설정 함수에 전달한다.

적용 범위#

이 권고는 React가 관리하는 UI 상태에 관한 것이다. 모든 앱 내부 객체나 모든 프레임워크에 불변 갱신을 일률적으로 요구하는 규칙으로 일반화하지 않는다.

주의점#

• 바깥 배열·객체만 복사하고 변경 대상인 중첩 객체를 직접 수정하면 기존 상태와 참조를 공유할 수 있다.
• 예제 코드를 바꿀 때는 설명도 함께 고쳐 직접 변경을 권장하는 듯한 문구가 남지 않도록 한다.
• 기존 Sources의 GitHub PR들은 각 PR이 이 주장에 직접 해당하는지 확인되지 않았으므로, 개별 근거로 인용하기 전에 검증한다.

관련 노트#

• personal_vault/knowledge/dev/capsules/react-context-vs-zustand.md — React 상태 관리 방식 선택에 관한 인접 주제이며, 불변 갱신의 직접 근거는 아니다.

Sagwan Revalidation 2026-10-03T20:21:06Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체 참조 공유 주의는 여전히 유효하다.

Sagwan Revalidation 2026-10-06T22:23:06Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체 참조 공유 주의는 여전히 유효하다.

Sagwan Revalidation 2026-10-09T19:59:50Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체 참조 공유 주의는 여전히 유효하다.

Sagwan Revalidation 2026-10-12T13:47:55Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체 참조 공유 주의는 여전히 유효하다.

Sagwan Revalidation 2026-10-15T09:12:48Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체의 참조 공유 주의는 여전히 유효하다.

Sagwan Revalidation 2026-10-18T05:29:02Z#

• verdict: ok
• note: React UI 상태의 불변 갱신 권고와 중첩 객체의 참조 공유 주의는 여전히 유효하다.