WORKSHOP NOTES
주소제트 작업실
도구와 문서를 연결해 작업을 끝내는 활용 기록.
매일 이어지는 작업실
실제 이용에 도움이 되는 질문을 골라 비교표와 사례로 풀어냅니다. 매일 오전 9시부터 새 글을 준비해 확인을 마친 뒤 발행합니다.

map으로 새 배열을 만들었는데 원본 값도 바뀌는 이유
새 배열과 새 객체는 다릅니다. JavaScript map에서 같은 객체를 반환한 경우와 객체를 복사한 경우를 직접 실행하고, 중첩 객체가 남는 한계까지 확인합니다.

배열 첫 항목만 못 찾는다면, indexOf의 0을 확인하세요
indexOf는 위치를, includes는 포함 여부를 돌려줍니다. 0과 -1을 조건문에 그대로 넣었을 때 생기는 오류를 작은 문자열 배열로 확인합니다.

12px가 숫자 12가 됐다면, parseInt와 Number를 구별하세요
숫자로 바뀌었다고 입력 전체가 유효한 것은 아닙니다. parseInt와 Number의 결과를 비교하고 빈 값·소수·범위까지 점검하는 작은 수량 입력 예제입니다.

URLSearchParams에서 같은 이름의 값이 여러 개일 때
tag=book&tag=map처럼 반복되는 쿼리 이름을 get과 getAll로 읽고, append와 set의 결과를 비교합니다. 작은 실행 예제로 값이 사라지는 원인을 확인합니다.

filter 결과가 비었다면, 조건 함수의 반환값부터 확인하세요
JavaScript filter의 화살표 함수에서 return을 빠뜨린 사례와 실제로 조건을 만족하는 값이 없는 사례를 구별합니다. 작은 숫자 배열로 결과를 직접 확인합니다.

숫자 10이 2보다 앞에 정렬됐다면, 비교 함수를 확인하세요
JavaScript sort()의 기본 비교와 숫자 비교를 직접 실행해 봅니다. 작은 배열로 결과를 확인하고 원본 배열 보존 여부까지 점검하는 재현 가능한 연습입니다.

JSON의 null, 빈 문자열, 숫자 0은 서로 다릅니다
자료를 읽을 때 null·빈 문자열·0·false를 한꺼번에 빈칸으로 바꾸지 않는 방법입니다. 작은 JSON 예시를 통해 값의 형식과 제공처가 정한 의미를 구별합니다.

GitHub 이슈가 닫혔다고 내 프로그램도 고쳐진 것은 아닙니다
이슈 종료, 코드 병합, 릴리스 배포, 내 설치 버전을 나누어 읽는 방법입니다. 오류를 검색한 뒤 어느 단계까지 확인했는지 기록하는 가상 사례를 제공합니다.

GitHub 파일이 필요한데 HTML을 받았다면 Raw 보기를 확인하세요
저장소의 파일 내용과 그 파일을 보여 주는 웹페이지를 구별합니다. 연습용 CSV를 예로 파일명·내용 첫 줄·버전을 대조하고 실행 없이 확인하는 방법입니다.

파일에는 글자가 있는데 VS Code 전체 검색에서는 안 나올 때
현재 파일 찾기와 작업 폴더 검색의 범위를 대조합니다. 제외 설정과 포함 경로를 확인하고 원본 파일을 바꾸지 않은 채 검색 누락의 원인을 좁히는 예시입니다.

GitHub에서 버전 숫자가 더 큰데 Pre-release라고 표시된다면
GitHub의 Latest와 Pre-release 표시는 서로 다른 역할을 합니다. 내려받기 전에 배포 설명과 내 환경을 확인하고 선택한 릴리스의 링크를 남기는 연습입니다.

VS Code 상단 경로의 함수 이름, 폴더로 착각하지 마세요
VS Code Breadcrumbs에서 파일 경로와 함수·클래스 같은 심볼을 구분합니다. 같은 이름의 파일을 찾아갈 때 폴더와 코드 위치를 따로 기록하는 예시입니다.

VS Code 타임라인의 저장 기록은 Git 커밋과 다릅니다
파일 타임라인에 보이는 로컬 저장과 Git 커밋을 구분합니다. 과거 내용을 읽기만 하는 연습으로 파일·기록 종류·변경 내용을 연결합니다.

VS Code에서 다른 파일을 누르면 앞의 탭이 사라지는 이유
탐색기에서 한 번 클릭해 연 파일은 미리보기 탭을 재사용할 수 있습니다. 파일 삭제와 화면 전환을 구분하고 계속 읽을 파일을 별도 탭으로 여는 방법입니다.

VS Code에서 줄이 사라져 보일 때, 접힌 코드부터 확인하세요
편집기에서 접힌 영역과 삭제된 내용을 구별합니다. 줄 번호와 접기 표시를 보고 다시 펼친 뒤, 원본과 비교하는 작은 파일 읽기 연습입니다.

들여쓰기가 어긋난 파일, 공백부터 바꾸기 전에 볼 것
VS Code 상태 표시줄에서 들여쓰기 방식을 확인하고 탭·공백 변환을 별도 사본에서 시험합니다. 자동 감지와 기본 설정, 현재 파일 내용의 차이를 구별합니다.

VS Code에서 다시 보이는 글, 파일에도 저장됐을까요?
편집기에 복원된 미저장 내용과 디스크에 저장한 파일을 구별합니다. 자동 저장 설정과 저장 위치를 확인하고 전달할 파일을 다시 여는 연습입니다.

VS Code 아래쪽 언어 표시가 파일 내용과 다를 때
상태 표시줄의 언어 모드는 편집기가 파일을 해석하는 방식입니다. 화면 언어·파일 확장자·실제 내용을 구분하고, 작은 예시 파일로 표시를 확인합니다.

파일 하나를 연 것과 작업 폴더를 연 것은 다릅니다
VS Code의 편집 탭과 작업 폴더 범위를 구분합니다. 같은 이름의 파일을 다른 폴더에서 수정하지 않도록 탐색기와 파일 경로를 확인하는 연습입니다.

여러 파일에서 바꾸기, 적용 전에 바뀔 줄부터 보세요
VS Code의 파일 검색과 바꾸기 미리보기로 수정 범위를 확인합니다. 가상의 연습 파일에서 현재 공지만 고치고 지난 기록은 남기는 작은 작업을 따라갑니다.

긴 줄이 접혀 보여도 파일에 줄바꿈이 생긴 것은 아닙니다
VS Code의 자동 줄 바꿈 표시와 Enter로 넣는 실제 줄바꿈을 구분합니다. 원본을 고치지 않고 긴 문장을 읽고, 파일의 줄 번호를 기준으로 위치를 남기는 연습입니다.

링크 뒤의 물음표와 해시, 지우기 전에 역할을 보세요
URL의 쿼리와 프래그먼트가 무엇을 가리키는지 작은 예제로 확인합니다. 주소를 줄이기 전에 검색 조건과 문서 안의 위치가 유지되는지 대조하는 방법입니다.

README를 옮겼더니 링크가 깨질 때, 기준 폴더부터 보세요
GitHub Markdown의 상대 링크는 현재 문서 위치를 기준으로 읽습니다. 작은 가상 폴더 구조로 문서 이동 전후의 링크와 이미지 경로를 직접 비교합니다.

GitHub에서 파일 찾기, 파일 이름과 본문 검색을 나누세요
GitHub의 Go to file로 파일 이름을 찾는 작업과 코드 본문 검색을 구분합니다. 저장소·브랜치·경로를 확인하고 찾은 파일의 검토 위치를 남기는 가상 연습입니다.

최종본이 두 개라면, 파일 이름 대신 바뀐 문장을 비교하세요
VS Code에서 두 텍스트 파일을 비교하는 방법입니다. 기준본과 검토본을 지정하고 달라진 줄의 의미를 읽어, 어떤 내용을 남길지 별도 기록하는 가상 작업 예시입니다.

한글이 깨진 텍스트 파일, 저장하기 전에 다시 열어 보기
VS Code의 인코딩으로 다시 열기와 인코딩하여 저장을 구분합니다. 원본을 보존한 채 읽는 방식을 확인하고, 실제 문자가 복구된 뒤 사본을 저장하는 작업 순서입니다.

Python 예제의 >>>까지 복사하면 왜 오류가 날까요?
Python 대화형 예제에서 입력 표시, 직접 입력할 코드, 실행 결과를 나눕니다. 짧은 계산과 반복문 예시로 들여쓰기와 계속 입력 표시를 함께 확인합니다.

파일 이름 끝을 .pdf로 바꾸면 PDF가 될까요?
파일 이름 변경·확장자·형식 변환·연결 앱을 구분합니다. 원본을 보존한 채 원하는 형식의 별도 파일을 만들고 내용까지 확인하는 작업 예시입니다.

이미지 설명에 파일명을 쓰면 될까요? 역할에 맞는 대체 텍스트
W3C WAI의 이미지 안내를 따라 정보·장식·기능 이미지를 구분합니다. 같은 그림도 쓰인 위치에 따라 설명이 달라지는 작은 웹문서 점검 예시입니다.

PDF에 글자가 보이는데 검색이 안 된다면: 스캔 이미지와 텍스트 확인하기
PDF 검색 결과가 없을 때 입력어·검색 옵션·텍스트 선택 여부를 순서대로 살펴봅니다. OCR 전후의 원본과 확인 기록을 구분하는 연습입니다.

ZIP을 풀기 전 저장 위치부터 정하기: 원본과 압축 해제 결과를 나누는 작업 기록
PowerShell Expand-Archive로 ZIP을 별도 폴더에 푸는 예시입니다. 대상 경로와 덮어쓰기 여부를 구분하고 원본·결과·출처를 연결합니다.

다운로드 파일 SHA256 확인하기: Get-FileHash 결과와 배포 기록 비교하는 법
파일 이름이 같아도 내용은 다를 수 있습니다. PowerShell에서 SHA256을 계산하고 같은 버전의 공식 기준값과 비교하는 절차, 일치 결과의 한계를 정리합니다.

JSON 파일이 열리지 않을 때: 문법 오류와 데이터 의미를 나누어 점검하기
괄호와 쉼표를 고쳐 파싱에 성공해도 값이 맞다는 뜻은 아닙니다. 짧은 JSON 예제로 문법 검사, 자료형 확인, 원본 보존을 나누는 점검 기록을 만듭니다.

Python 문서와 실행 환경 맞추기: 버전 링크를 작업 기록으로 남기는 법
검색에서 찾은 최신 문서가 현재 프로젝트의 설명과 같지는 않습니다. Python 버전, 가상환경과 문서 링크를 한 기록에 묶어 명령을 복사하기 전 확인할 순서를 제안합니다.

GitHub 코드 링크가 바뀌지 않게 남기기: 브랜치 주소와 커밋 고정 링크
리뷰에서 본 코드와 나중에 열린 코드가 다르면 근거를 확인하기 어렵습니다. 특정 버전 링크와 최신 브랜치 링크를 목적별로 나누는 작업 예시입니다.

링크가 안 열릴 때 개발자 도구로 확인할 것: 상태 코드와 최종 주소 읽기
404·403·리디렉션을 같은 오류로 묶지 않고 관찰 내용을 기록합니다. 브라우저 Network 패널과 HTTP 문서를 연결하는 작은 진단 작업입니다.

업무 도구 비교는 작은 작업부터: 기능표 대신 결과물로 고르는 방법
무료 기능 수나 소개 문구보다 실제로 끝낼 작업을 기준으로 도구를 비교합니다. 입력·출력·이동 가능성을 확인하는 실험표입니다.

CSV를 열었더니 값이 달라질 때: 인코딩·구분자·자료형 점검표
한글 깨짐과 열 분리, 앞자리 0 손실을 서로 다른 문제로 나눕니다. 원본을 보존하면서 공개 데이터를 확인하는 작업 순서를 정리했습니다.

오류 메시지로 해결책 찾기: 버전·환경·이슈 상태를 함께 읽기
오류 문구만 같은 해결책을 그대로 적용하지 않도록 검색 범위를 좁힙니다. GitHub 이슈와 공식 문서를 대조하는 재현 메모를 제공합니다.

API 문서를 읽는 순서: 인증·요청·응답·제한을 한 장에 정리하기
코드를 작성하기 전에 필요한 요청과 기대하는 결과를 좁힙니다. 공개 데이터 조회를 예로 문서의 조건을 작업 계획으로 옮기는 방법입니다.

자료조사 폴더를 다시 이해할 수 있게 만드는 법: 원본·작업·결과 분리하기
다운로드 파일과 원문 주소, 수정 기록을 연결해 조사 과정을 보존합니다. 파일 이름만으로 관리하지 않는 작업실 폴더 설계입니다.

CSS 예제를 붙이기 전에: MDN 설명과 브라우저 지원 정보를 함께 보는 법
CSS 문법을 찾는 문서와 브라우저 지원 표의 역할을 구분합니다. MDN·Can I use를 연결해 기능 확인부터 실제 기기 점검까지 진행하는 작업 흐름입니다.

GitHub에서 무엇을 내려받아야 할까: 소스 ZIP·저장소 복제·릴리스 구분
GitHub의 소스 코드 압축파일과 저장소 복제가 담는 범위를 비교합니다. 실행 파일을 찾는 상황과 코드를 읽는 상황을 나누고 버전 기록 방법을 정리합니다.

공공데이터 찾기 전에: 파일 다운로드와 API 중 어떤 경로가 필요한가
일회성 표 분석과 반복 조회 작업의 차이에서 시작해 공공데이터의 제공 방식·기준 기간·단위를 점검합니다. 다운로드 날짜와 자료 기준일을 나누어 기록합니다.

arXiv 논문 링크를 저장할 때 버전 번호까지 남겨야 하는 이유
arXiv의 최신 버전 링크와 특정 버전 식별자를 구분합니다. 읽은 버전·확인 날짜·검토한 부분을 기록해 나중에 같은 자료를 다시 찾는 방법입니다.
이 블로그의 편집 기준
공식 자료와 확인 가능한 화면을 바탕으로 작성하며, 제안하는 작업 방식과 확인한 사실을 구분합니다. 예시는 실제 이용 후기나 통계로 표현하지 않습니다. 발행일과 자료 확인일은 실제 날짜로 기록하고 내용이 바뀌면 재검토합니다.
주소모음·링크모음으로 돌아가기 ↗