일기 slecs

불필요한 사이트 검증 태그 제거

목차

구글 사이트 검증용 메타 태그를 Astro 레이아웃 파일에서 정리했다. 한두 줄 짜리 작은 chore지만, 이런 누적된 정리 작업이 코드베이스를 건강하게 유지한다는 점에서 중요하다고 본다.

사이트 검증 메타 태그, 언제 필요한가

google-site-verification 메타 태그는 검색 엔진 서치 콘솔에서 사이트 소유권을 증명할 때 필요하다. HTML의 <head>에 직접 삽입하면, 크롤러가 이 태그를 감지해서 도메인이 진짜 내 것인지 확인하는 방식이다.

<meta name="google-site-verification" content="xxxxx...">

보통은 신규 사이트 런칭, 도메인 변경, SEO 도구 연동 등 초기 설정 단계에서 잠깐 필요하다. 검증이 끝나면 기술적으로는 굳이 남겨둘 이유가 없다. 그런데도 "혹시 모르니" 하며 코드에 계속 남겨두는 경우가 많다.

Dex.astro 에서의 역할과 정리 포인트

src/layouts/Dex.astro는 메인 페이지 레이아웃 컴포넌트다. Astro에서는 보통 공통 레이아웃 파일에 전역 메타 태그를 관리한다. 검증 태그도 처음엔 여기 하드코딩되어 있었을 것이다.

커밋 메시지의 "not needed"는, 검증이 이미 완료되었거나 요구사항 자체가 변경되어 더 이상 기능 효과가 없는 코드라는 뜻이다. 한 번 역할을 마친 코드인데, 계속 번들에 남아 있던 것이다.

왜 이런 정리가 자주 미뤄질까

"메타 태그 하나쯤 뭐하나" 싶지만, 이런 식으로 누적되면:

  • 가독성 악화: 팀원이 코드를 읽을 때 "이 태그가 실제로 쓰이나?" 하고 헷갈린다
  • 디버깅 비용 증가: 메타 태그 관련 버그나 SEO 이슈가 생기면, 불필요한 설정까지 추적해야 한다
  • 번들 최적화 기회 상실: 미미하지만 HTML 크기가 늘어나고, 빌드 산출물에 쓸데없는 정보가 섞인다
  • 유지보수 복잡도: 메타 태그 리스트를 정리할 때마다 "이건 뭐지?" 같은 질문이 반복된다
  • 보안 정보 노출: 어떤 도구, 서비스를 썼는지에 대한 정보가 노출되는 미세한 위험

큰 것 같지 않지만, 레이아웃 파일 같은 핵심 컴포넌트에 이런 것들이 쌓이면 나중에 유지보수가 굉장히 번거로워진다.

팀 문화로서의 정리

팀 리딩 관점에서, 나는 이렇게 생각한다: "쓰지 않는 코드를 정리하는 것도 중요한 개발 일감이다."

큰 feature를 만드는 것만이 progress가 아니라, 불필요한 레거시를 주기적으로 정리하는 것도 팀의 속도와 안정성을 높인다. 이를 위해 팀 내에서 지향하는 것들:

  • 코드 리뷰 때 "왜 이게 있나요?"라는 질문이 자연스러운 문화
  • 변경 사항 발생 시 관련 불필요 코드도 함께 정리 (정리는 나중에 금지)
  • 주석만 남겨두지 않기 (진짜 삭제하고, git history로 충분)
  • 신뢰 기반 결정 ("혹시 모르니 남겨두자" 보다 "필요할 땐 git에 있다")

메타 태그 관리의 판단 기준

메타 태그, 환경 변수, 설정값을 다룰 때 우리 팀의 판단 프레임:

상황 판단 처리 방법
기능 종료 후 태그 남음 불필요함 명확 즉시 삭제
"혹시 모르니 남겨두고 싶음" git history로 충분 삭제
아직 쓸지 말지 불명확 feature flag로 관리 하드코딩 금지
레거시 브라우저 지원 중 deadline 명시 정리 시점 공지

이번 검증 태그는 1번 케이스다. 검증은 이미 끝났고, 기능 효과도 없다. 정리는 당연한 결정이다.

회고: 작은 실천의 누적

이런 작은 정리 작업을 개별로 보면:
- 시간 투입: 1분 미만
- 코드 영향: 무시할 수 있는 수준
- 기술적 리스크: 거의 없음

하지만 팀 전체로 보면, 이런 일감들을 정기적으로 처리하는 것이 습관화되면 코드베이스가 명확하고 간결해진다. 새로운 팀원도 "이 팀은 정리를 중시하는군"이라고 느낀다.

큰 feature deliver도 중요하지만, 동시에 이렇게 작은 chore 작업도 당당하게 commit하고 리뷰하고 머지하는 것을 자연스럽게 만드는 게 건강한 코드베이스를 만드는 지름길이다. 그것이 팀의 신뢰도 높이고, 장기적으로 속도도 낸다고 본다.


🛒 이 글과 어울리는 추천 상품

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.

댓글 0

첫 댓글 달아줘.