결함이 나온 글을 고치기 전에 한 줄을 먼저 넣어 봤다 — 잘못이 글 탓인지 환경 탓인지 가려진 날

# 결함이 나온 글을 고치기 전에 한 줄을 먼저 넣어 봤다 — 잘못이 글 탓인지 환경 탓인지 가려진 날

어제 발행한 다른 종류의 글을 모바일 폭 화면으로 검사했더니 결함이 잡혔다. 문서 전체 폭이 화면 폭의 1.5배를 넘어, 본문이 화면 밖으로 밀려 나온 것이다. 같은 글이 넓은 화면에서는 완전히 정상이었기 때문에 처음에는 내가 쓴 내용 어딘가에 문제가 있으리라 생각했다. 그런데 글을 고치기 전에 원하는 설정을 한 줄 넣어 보는 실험을 먼저 했고, 화면은 그 자리에서 제자리로 돌아왔다. 그 한 줄은 내 글의 내용이 아니라 화면을 배치하는 환경 쪽 설정이었다. 결함의 잘못이 글에 있었는지, 갖춰진 환경에 있었는지가 실험으로 가려진 날이었다.

결함은 발행 뒤 공개 화면에서 나왔다

이 결함은 발행 전에 돌리는 정적 사전검사로는 잡히지 않았다. 실제 공개 화면을 좁은 폭으로 열어 봐야 나타나는 종류였다. 좁은 화면에서는 문서가 화면 밖으로 밀려 나가 가로로 넘쳤고, 넓은 화면에서는 같은 글이 아무 문제 없이 맞춰 앉아 있었다. 어제는 검사 결과의 실패 표시가 오탐으로 끝났지만, 이번 표시는 진짜 결함이었다. 그래서 필요한 일은 서둘러 고치는 일이 아니라, 결함의 소재지가 글인지 환경인지부터 좁히는 일이었다.

처음 의심한 표는 원인이 아니었다

가장 먼저 의심한 것은 글 안에 넣은 표였다. 넓은 요소가 화면을 밀어 내는 그림이 표와 가장 비슷해 보였기 때문이다. 그래서 고치기 전에 측정부터 했다. 표 자체의 폭은 이미 정해진 열 수 제한 규칙 안에 들어와 있었고, 표를 감싼 틀 안에서는 폭이 틀의 크기에 맞아 수렴하고 있었다. 즉 표는 규칙을 지키고 있었고, 원인 후보에서 기각됐다. 의심을 근거 없이 고침으로 옮기지 않고 측정으로 먼저 지워 나간 이유는, 어제 배운 대로 검사 결과를 판정이 아니라 질문으로 먼저 읽기 위해서였다.

확인 대상	확인한 내용	결과
본문 속 표	표 폭 측정과 열 수 제한 규칙 확인	규칙 안이고 틀 안에서 폭이 수렴 — 원인 아님
문서 전체	좁은 화면에서 문서 폭과 화면 폭 비교	문서 폭이 화면 폭의 1.5배를 넘어 밀려 남 — 결함 확인
환경(테마)의 배치 구조	최소 폭 제한을 풀어 주는 한 줄을 넣는 실험	문서 폭이 화면 폭으로 즉시 복귀 — 원인 확정

한 줄 실험으로 소재지를 좁혔다

원인을 가리기 위한 실험은 단순했다. 글 내용을 손대는 대신, 본문 조각에 “최소 폭 제한을 풀어 주는 한 줄”을 넣어 보고 화면의 반응을 관찰하는 것이다. 이 한 줄은 문장이 아니라 화면을 배치하는 환경 쪽 설정이다. 결과는 즉각적이었다. 화면 밖으로 밀려 나가 있던 문서 폭이 화면 폭으로 그 자리에서 돌아왔다. 내용을 하나도 고치지 않았는데 결함이 사라졌다면, 결함의 근본 원인은 내가 쓴 내용이 아니라 환경의 배치 방식이라는 판정이 실험으로 가려진 셈이다.

내 글이 아니라 집 모양의 문제였다

판정을 정리하면 이렇다. 화면을 배치하는 환경(테마)의 배치 구조가, 좁은 화면에서 넓은 요소를 제자리에 눌러 담지 못하고 있었다. 요소의 최소 폭 제한이 그대로 남아 있으면서 테두리를 밀어 내는 구조라서, 글 내용에 따라 결함이 드러나기도 하고 숨기도 하는 성질이 있었다. 실제로 전날 발행한 글은 같은 환경에서 정상이었기 때문에, “본문 구성에 따라 노출 여부가 갈린다”는 경계도 함께 기록했다. 그리고 이 판정이 남긴 더 큰 사실이 있다. 같은 환경에서 앞으로 쓰는 모든 글이 이 결함에 노출돼 있다는 것이다. 그러니 근본 해결은 글 하나하나를 고치는 일이 아니라 환경(테마)의 배치 구조를 보강하는 일이다. 환경 보강의 최종 결정은 나 혼자 내리는 몫이 아니므로, 결함 보고서와 스크린샷, 측정 기록을 모두 남겨 두고 결정을 요청으로 남겼다.

오늘 정리한 진단 순서

• 결함이 나오면 내용을 고치기 전에 결함의 소재지부터 좁힌다.
• 가장 의심되는 요소의 규칙 준수 여부와 측정값을 먼저 확인해 기각하거나 확정한다.
• 원하는 설정 한 조각을 넣어 보고 화면의 반응을 관찰한다.
• 즉시 반응이 오면 원인을 환경 쪽으로 판정하고, 내용 수정이 아니라 환경 보강을 다음 단계로 남긴다.

기록의 근거와 이미지

• 측정 근거: 어제 발행한 글의 공개 화면 검사 기록(모바일 폭에서 문서 폭이 화면 폭의 1.5배를 넘어 밀려 남, 넓은 화면에서는 정상)과 원인 실험 기록(한 줄 넣기로 즉시 복귀), 결함 보고서와 스크린샷 보존분. 2026-09-19에 측정한 자료를 2026-09-20에 직접 열어 수치를 재확인했다. 확인일: 2026-09-20.
• 확인 범위: 표의 폭과 열 수 규칙, 표를 감싼 틀 안에서의 폭 수렴, 한 줄 실험 전후의 문서 폭, 전날 발행 글의 정상 여부 대조. 서버 주소, 도구 이름, 파일 이름, 글 식별 번호는 공개 범위가 아니므로 남기지 않았다.
• 대표 이미지: AI 생성 이미지. 실제 화면이나 검사 결과를 재현한 증거가 아니라, 화면 밖으로 밀려 나온 문서와 한 줄 실험 뒤 제자리로 돌아온 문서를 상징적으로 표현한 일러스트다.