path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

data-parsing

Windows zip 콜론 파일명 오류로 막힌 압축 해제 해결법

J.Lab ·
목차

    최근 오래전부터 운영하던 티스토리 블로그 백업을 위해 전체 데이터를 zip 파일로 다운로드했다. 소중한 글들을 로컬 컴퓨터에 안전하게 보관하고, 필요한 데이터만 뽑아서 정리해 두려던 참이었다. 그런데 평소처럼 윈도우 탐색기에서 마우스 우클릭을 하고 압축 해제를 시도하는 순간, 뜬금없는 오류 창이 뜨며 작업이 중단되었다.

    처음에는 다운로드 파일이 손상된 줄 알았다. 하지만 자세히 살펴보니 원인은 다름 아닌 파일 이름에 있었다. 백업 폴더 안에 있는 글 중 일부 파일명에 콜론(:) 문자가 포함되어 있었던 것이다. 윈도우 환경에서 파일 이름으로 사용할 수 없는 문자가 들어가 있는 바람에 탐색기가 에러를 내뱉은 셈이었다.

    윈도우에서 파일명 내 콜론 특수문자로 인해 zip 압축 해제 오류가 발생하는 장면을 묘사한 벡터 일러스트

    Windows zip 콜론 파일명 제약에 걸리다

    문제가 발생한 원인은 명확했다. 윈도우가 사용하는 NTFS 파일시스템과 리눅스 기반 환경의 파일시스템 간의 규칙 차이 때문이다. 내가 백업한 데이터 중에는 과정-V8처럼 제목이나 태그에서 유래되어 콜론(:)이 고스란히 포함된 파일명이 존재했다.

    윈도우에서는 시스템 보호와 예약어 관리 등의 이유로 파일명에 콜론을 사용하는 것을 아예 허용하지 않는다. 이 제약 조건 때문에 Windows zip 압축을 풀 때 파일 생성 단계에서 실패하고 말았던 것이다. 아무리 성능 좋은 압축 해제 소프트웨어를 깔아서 돌려봐도, 운영체제 자체의 강력한 제약을 넘어설 수는 없었다.

    결국 윈도우라는 환경을 잠시 벗어나야 한다는 결론에 도달했다. 리눅스 계열의 OS라면 이 콜론을 파일명으로 너그럽게 수용해 줄 것이 분명했기 때문이다.

    Linux unzip 명령어로 가볍게 해결하기

    어떻게 리눅스 환경을 쉽고 빠르게 쓸 수 있을지 고민하다가, 가볍게 접근할 수 있는 구글 앱스 스크립트(GAS) 샌드박스의 bash 환경을 활용하기로 했다. 거창하게 가상머신을 띄우거나 듀얼 부팅을 세팅할 필요 없이 가벼운 샌드박스 터미널만 있으면 충분했다.

    준비된 리눅스 환경에 백업 zip 파일을 무사히 업로드했다. 이어서 터미널 창을 열고 대중적인 Linux unzip 명령어를 입력해 압축을 해제했다. 결과는 대성공이었다. 윈도우에서 그렇게 속을 썩이던 콜론 파일명들이 아무런 저항도 없이 원래 이름 그대로 얌전하게 압축 해제되었다.

    리눅스 샌드박스 환경 터미널에서 unzip 명령어를 사용해 무사히 압축을 해제하는 과정을 표현한 일러스트

    추출된 결과물을 보니 총 15건의 온전한 파일들이 생성되어 있었다. 파일시스템이 다른 두 환경을 오가며 우회하는 것만으로 막혔던 작업이 단번에 풀리는 경험은 언제 겪어도 참 흥미롭다.

    HTML 파싱과 구글 시트 수동 임포트

    이렇게 무사히 받아낸 15건의 파일들은 원본 형태인 HTML 포맷으로 저장되어 있었다. 단순히 파일로 가지고 있는 것보다 텍스트 데이터를 정제하여 나만의 아카이브를 만들고 싶어졌다. 이를 위해 HTML 구조를 분석해 글 제목, 카테고리, 작성일자, 그리고 본문 텍스트를 추출하는 작업을 시작했다.

    데이터 구조가 복잡하지 않아 필요한 핵심 요소들만 쏙쏙 끄집어낼 수 있었다. 추출한 정보들을 보기 좋게 쉼표로 분리한 CSV 형태의 데이터로 가공하여 하나의 통합 파일로 빌드했다.

    추출한 HTML 파일을 CSV 형태로 변환하여 구글 스프레드시트에 수동으로 임포트하는 가공 프로세스 일러스트

    이렇게 만들어진 CSV 파일을 구글 스프레드시트(Google Sheets)에 수동으로 가져오기(Import)를 실행했다. 셀마다 제목과 본문이 질서정연하게 채워지는 광경을 목격하자마자, 이전에 겪었던 파일명 제약 삽질에 대한 모든 피로가 한순간에 씻겨 내려가는 듯했다.

    마치며

    OS마다 파일명을 다루는 규칙이 다르다는 사실을 다시금 몸소 실감했다. 윈도우 환경에서 압축 해제 실패로 곤혹을 치르고 있다면, 파일명 제약 조건을 의심해 보고 리눅스 터미널을 활용해 보는 것을 강력히 추천한다. 이번 경험을 통해 이기종 운영체제 간의 데이터 호환성을 다룰 때는 항상 파일시스템 제약을 염두에 두어야 한다는 소중한 배움을 얻었다.

    data-parsing filesystem linux unzip windows zip
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger