Microsoft가 공개한 Flint는 AI 에이전트가 데이터의 의미와 원하는 차트 유형을 바탕으로 시각화를 생성할 수 있도록 설계된 오픈 소스 시각화 언어입니다. 복잡한 차트 옵션을 직접 작성하지 않아도 Vega-Lite, ECharts, Chart.js 등에 사용할 수 있는 결과를 만들 수 있다는 점이 특징입니다.
Flint 프로젝트에서는 차트 설정, 원본 데이터, 컴파일 결과를 JSON 파일로 저장하는 경우가 많습니다. 하지만 프로젝트 폴더를 정리하거나 AI 코딩 도구가 파일을 자동으로 수정하는 과정에서 중요한 JSON 파일이 삭제될 수 있습니다.
이 글에서는 삭제된 Flint JSON 파일을 복구하는 방법과 복구 후 확인해야 할 사항을 간단히 정리합니다.
Flint JSON 파일이란?
Flint에는 반드시 사용해야 하는 전용 파일 확장자가 없습니다. 일반적으로 Flint JSON 파일은 차트 종류와 축 정보를 저장하는 차트 설정 파일, 차트에서 사용하는 원본 데이터 파일, 또는 Vega-Lite, ECharts, Chart.js용으로 생성된 결과 파일을 의미합니다.
이 가운데 가장 중요한 것은 Flint의 원본 차트 설정 파일입니다. 원본 설정이 남아 있으면 여러 차트 라이브러리용 결과를 다시 생성할 수 있기 때문입니다.
Flint JSON 파일이 삭제되는 이유
Flint는 VS Code, Git, MCP 클라이언트 및 AI 코딩 에이전트와 함께 사용할 가능성이 높습니다. 따라서 일반 문서보다 파일이 자주 생성되거나 교체될 수 있습니다.
Flint JSON 파일은 프로젝트 폴더를 정리하는 과정에서 실수로 삭제되거나, AI 에이전트가 기존 파일을 새 파일로 교체하면서 사라질 수 있습니다. 또한 Git 정리 명령으로 추적되지 않은 파일이 제거되거나 OneDrive 동기화 오류로 파일이 누락되는 경우도 있습니다. 이 밖에도 SSD, 외장 하드 또는 USB를 잘못 포맷했거나, 파일 저장 중 프로그램이 갑자기 종료되면서 JSON 파일이 손상될 수 있습니다.
파일 삭제를 확인했다면 해당 드라이브에 새로운 파일을 저장하지 않는 것이 좋습니다. 새로운 데이터가 기록되면 삭제된 JSON 파일의 저장 공간이 덮어써질 수 있습니다.
방법 1. 휴지통 확인하기
일반적인 삭제 방식으로 제거했다면 먼저 Windows 휴지통을 확인하세요.
바탕화면에서 휴지통을 엽니다.
검색창에 .json 또는 파일 이름을 입력합니다.
필요한 파일을 선택합니다.
-
마우스 오른쪽 버튼을 클릭하고 복원을 선택합니다.
복원된 파일은 원래 Flint 프로젝트 폴더로 돌아갑니다.
단, Shift + Delete로 삭제했거나 휴지통을 비운 경우에는 다른 방법이 필요합니다.
방법 2. VS Code 기록에서 복구하기
Flint JSON 파일을 VS Code에서 편집했다면 Local History 또는 Timeline에 이전 내용이 남아 있을 수 있습니다.
프로젝트 폴더를 연 뒤 Timeline에서 해당 파일의 이전 저장 기록을 확인하세요. 파일 자체가 삭제된 경우에는 명령 팔레트에서 Local History: Find Entry to Restore를 검색해 복원 가능한 기록을 찾을 수 있습니다.
이 방법은 최근 편집 내용을 실수로 덮어썼을 때도 유용합니다.
방법 3. Git에서 이전 버전 복원하기
Flint 프로젝트를 Git으로 관리하고 있었다면 삭제된 JSON 파일을 이전 커밋에서 복원할 수 있습니다.
먼저 git status를 실행해 삭제된 파일을 확인한 뒤 Git의 Restore 기능을 사용하세요. GitHub Desktop을 사용한다면 변경 사항 목록에서 삭제된 파일을 선택하고 변경을 취소할 수도 있습니다.
다만 JSON 파일을 한 번도 Git에 추가하거나 커밋하지 않았다면 Git 기록에서는 찾을 수 없습니다.
방법 4. OneDrive 또는 백업 확인하기
프로젝트 폴더를 OneDrive에 저장했다면 OneDrive 웹사이트의 휴지통을 확인하세요.
파일이 삭제된 것이 아니라 잘못된 내용으로 덮어써졌다면 버전 기록에서 이전 상태를 복원할 수 있습니다. Windows 파일 히스토리를 활성화해 두었다면 프로젝트 폴더의 이전 버전을 확인하는 방법도 있습니다.
백업이 남아 있다면 데이터 복구 프로그램을 사용하기 전에 백업 파일부터 복원하는 것이 가장 안전합니다.
방법 5. 4DDiG로 삭제된 Flint JSON 파일 복구하기
휴지통, VS Code, Git 및 OneDrive에서 파일을 찾지 못했다면 저장 장치를 직접 스캔해야 합니다.
이때 Tenorshare 4DDiG 데이터 복구를 이용하면 SSD, HDD, USB, 외장 하드 및 SD 카드에서 삭제된 파일을 검색할 수 있습니다. 실수로 삭제한 경우뿐 아니라 포맷, 파티션 손실 또는 시스템 오류로 사라진 파일을 찾을 때도 활용할 수 있습니다.
안전한 다운로드
4DDiG 사용 방법
-
4DDiG를 실행하고 JSON 파일이 저장되어 있던 드라이브를 선택합니다.
-
잠시 기다리면, 삭제해 버린 파일이 표시됩니다. 복구 전에, 사진, 비디오, 영화, 오디오, 음악, 문서 등의 파일을 더블 클릭하여 미리보기가 가능합니다.
-
복구하고 싶은 파일을 선택하고, 저장 위치를 선택합니다. 예를 들어 OneDrive 또는 Google Drive 등의 클라우드 디스크에 저장하는 것을 검토해 주세요.
주의:
※데이터 덮어쓰기를 방지하기 위해, 원래 저장 위치와 다른 드라이브나, OneDrive・Google 드라이브 등의 클라우드 스토리지를 저장처로 선택하는 것을 권장합니다.
또한 4DDiG는 삭제된 파일을 검색하는 데이터 복구 도구입니다. JSON 파일 내부의 문법 오류를 자동으로 수정하는 전용 JSON 복구 기능은 아니므로, 파일 복구 후에는 별도의 검사가 필요합니다.
복구한 JSON 파일 확인하기
JSON 파일을 되찾았다면 먼저 VS Code나 텍스트 편집기로 열어 내용을 확인하세요.
복구한 JSON 파일의 크기가 0KB로 표시되거나 내용이 중간에서 갑자기 끝난다면 파일 일부가 손상되었을 가능성이 있습니다. 또한 중괄호나 따옴표가 제대로 닫히지 않거나 VS Code에서 빨간색 오류 표시가 나타나는 경우에도 JSON 구조를 확인해야 합니다. 파일은 정상적으로 열리지만 Flint에서 차트가 생성되지 않는다면 데이터 필드, 차트 설정 또는 연결된 파일 경로가 누락되거나 손상되지 않았는지 점검하세요.
Flint 원본 설정 파일이라면 데이터, 차트 종류, 축 및 인코딩과 관련된 항목이 남아 있는지 확인해야 합니다. 차트에서 지정한 필드 이름과 실제 데이터의 열 이름도 정확히 일치해야 합니다.
JSON 문법은 정상인데 차트가 표시되지 않는다면 데이터 파일 경로가 변경되었거나 원본 데이터 파일이 함께 삭제되지 않았는지 확인하세요.
Flint JSON 파일 손실을 예방하는 방법
Flint 프로젝트를 계속 사용할 예정이라면 원본 JSON 파일과 생성된 결과 파일을 분리해 관리하는 것이 좋습니다. 원본 차트 설정 파일은 Git에 정기적으로 커밋하고, 전체 프로젝트 폴더는 OneDrive나 GitHub에 백업해 두세요. 또한 원본 데이터와 생성된 차트 결과를 서로 다른 폴더에 저장하고, 파일 이름에 날짜나 버전 번호를 추가하면 필요한 파일을 더 쉽게 구분할 수 있습니다. AI 에이전트가 기존 파일을 수정하거나 교체하기 전에는 별도의 백업본을 만들어 두는 것도 파일 손실을 예방하는 데 도움이 됩니다.
특히 컴파일된 차트 결과만 보관하지 말고 Flint 원본 설정 파일을 함께 저장해야 합니다. 원본이 남아 있으면 다른 차트 백엔드용 결과를 다시 만들 수 있습니다.
자주 묻는 질문
1, 삭제된 Flint JSON 파일을 완전히 복구할 수 있나요?
휴지통, VS Code Local History, Git 또는 클라우드 백업에 파일이 남아 있다면 원본 상태로 복원할 가능성이 높습니다. 데이터 복구 프로그램을 사용하는 경우에는 삭제 후 해당 드라이브에 새 데이터가 얼마나 기록되었는지가 중요합니다.
2, 0KB로 복구된 JSON 파일도 수정할 수 있나요?
파일 크기가 0KB라면 실제 JSON 내용이 남아 있지 않을 가능성이 큽니다. 이 경우 구문을 수정하는 방식으로는 복구할 수 없습니다. VS Code 기록, Git 커밋, 클라우드 버전 기록 또는 다른 복구 결과를 확인해야 합니다.
3, 4DDiG File Repair로 JSON 파일을 고칠 수 있나요?
삭제된 JSON 파일을 찾는 작업에는 4DDiG 데이터 복구 기능이 적합합니다. JSON은 텍스트 기반의 구조화 데이터이므로 사진·영상·문서용 File Repair 기능을 JSON에 직접 적용한다고 설명하는 것은 적절하지 않습니다. 파일을 복구한 후 문법 오류가 있다면 VS Code나 JSON 검사 도구로 구조를 수정해야 합니다.
4, 컴파일된 Vega-Lite JSON만 남아 있어도 차트를 복원할 수 있나요?
해당 백엔드에서 차트를 다시 렌더링하는 것은 가능할 수 있습니다. 하지만 원래 Flint 입력의 semantic_types나 일부 의미 정보는 복원되지 않을 수 있습니다. 따라서 백엔드 JSON은 참고 자료로 사용하고 원본 Flint 입력을 별도로 관리하는 것이 좋습니다.
마무리
삭제된 Flint JSON 파일을 발견했다면 가장 먼저 드라이브 사용을 중단하고 휴지통, VS Code Local History, Git 및 OneDrive 기록을 확인하세요. 이 방법들은 별도의 복구 과정 없이 원본 파일을 되찾을 가능성이 가장 높습니다.
백업이 전혀 없고 휴지통까지 비운 상태라면 4DDiG로 파일이 저장되어 있던 드라이브를 스캔해 볼 수 있습니다. 스캔 결과에서 .json, 원래 파일명, 프로젝트 경로 및 수정 날짜를 기준으로 파일을 찾은 뒤 반드시 다른 위치에 복구하세요.
마지막으로 복구된 파일의 JSON 문법뿐 아니라 data, semantic_types, chart_spec, encodings가 정상적으로 연결되어 있는지 확인해야 합니다. 원본 Flint 입력을 Git이나 클라우드에 보관해 두면 다음부터는 몇 줄의 복원 명령만으로 프로젝트를 다시 살릴 수 있습니다.
