程式碼定位、追蹤與修改操作筆記

LSP와 AST 기반 정밀 분석을 통한 Swift 코드 추적 및 안전한 수정 워크플로우 설계

Hsin-Chieh Cheng2026년 6월 3일5분intermediate

AI 요약

Context

AI 도구 없이 대규모 Swift 프로젝트 내에서 함수 정의와 데이터 흐름을 정확히 파악해야 하는 기술적 제약 존재. 특히 Xcode의 .xcodeproj 참조 관리와 동적 디스패치로 인한 심볼 오인식 문제를 해결해야 하는 상황임.

Technical Solution

rg를 활용한 텍스트 패턴 매칭으로 1차 탐색 범위를 신속히 축소하는 계층적 검색 전략 도입
SourceKit-LSP와 Xcode Index를 통해 단순 텍스트가 아닌 심볼의 실제 의미와 타입 정보를 검증하는 정밀 분석 단계 구성
SwiftSyntax 및 tree-sitter를 이용한 AST/CST 분석으로 함수 선언 및 할당 등의 구문 구조적 특성 파악
Xcode MCP(Write, RM, MV)를 통해 파일 시스템과 .xcodeproj 프로젝트 참조 간의 동기화 일관성 유지
'선언 → 적용 → 콜백 → 비즈니스 로직'으로 이어지는 다단계 데이터 흐름 추적을 통한 런타임 동작 검증
apply_patch와 git diff를 조합하여 최소 단위의 변경 사항을 적용하고 사이드 이펙트를 방지하는 안전한 수정 프로세스 수립

실천 포인트

- 단순 문자열 검색(rg) 후 반드시 LSP/Xcode Index로 실제 심볼 일치 여부 확인 - Swift 파일 추가/삭제 시 파일 시스템 조작 대신 Xcode MCP 도구를 사용하여 프로젝트 참조 무결성 확보 - 데이터 흐름 분석 시 선언부 확인에 그치지 않고 실제 런타임에 적용되는 지점과 비즈니스 필터링 로직까지 추적 - 수정 후 xcodebuild를 통한 타겟 빌드 및 특정 테스트 케이스 수행으로 회귀 오류 방지

태그

#LSP #Swift #Xcode MCP #AST #Static Analysis

원문 읽기