ViewCSV 확장 프로그램 도움말

파일이 열리지 않을 때

• 52,428,800바이트(50 MB)보다 큰 파일: 파일을 나누거나 데스크톱 프로그램을 사용하세요.
• “CSV 파일이 아니라 Excel 같은 스프레드시트 통합 문서입니다.”: 스프레드시트 프로그램에서 CSV UTF-8 형식으로 저장한 뒤 그 파일을 여세요.
• “텍스트가 아닌 바이너리 파일로 보입니다.”: 압축 파일(.gz)은 먼저 압축을 풀어야 하며, PDF는 지원하지 않습니다.
• 1,000,000행, 1,000열, 5,000,000셀 중 하나를 넘는 경우: 열 개수가 이상하다면 구분 기호가 잘못 인식되었을 가능성이 높습니다(아래 참고).

한글이 깨지거나 “올바른 UTF-8 텍스트가 아닙니다”라고 나올 때

ViewCSV는 UTF-8과 BOM이 있는 UTF-16을 자동 감지합니다. 예전 방식으로 저장한 스프레드시트 파일은 다른 인코딩을 쓰는 경우가 많습니다. 한국어 Windows용 Excel에서 “CSV(쉼표로 구분)”으로 저장한 파일은 대개 EUC-KR(CP949)이고, CSV UTF-8 형식으로 저장한 파일은 UTF-8입니다. 서유럽 언어 Windows에서 만든 파일은 보통 Windows-1252입니다.

1. ‘가져오기 설정’을 여세요. 시작 화면에 있고, 파일을 연 뒤에는 상단 막대에 있습니다.
2. ‘인코딩’에서 파일을 저장할 때 쓴 인코딩을 고르세요. 한국어 파일이라면 한국어(CP949), 즉 EUC-KR이며, 그 밖에 Windows-1252, Windows-1250, Windows-1251, Shift_JIS, GB18030 등을 선택할 수 있습니다.
3. 파일을 다시 열거나 ‘다시 읽기’를 선택하세요. 파일 자체는 변환하지 않습니다. UTF-8이나 UTF-16에 맞지 않는 바이트는 오류로 표시되지만, 다른 인코딩은 잘못된 바이트도 오류 없이 읽어 버릴 수 있습니다. 한글이 여전히 깨져 보이면 다른 인코딩을 선택해 보세요.

모든 내용이 한 열에 들어갈 때

구분 기호를 인식하지 못한 경우입니다. ‘가져오기 설정’에서 쉼표, 세미콜론, 탭, 세로 막대 중 하나를 고른 뒤 ‘다시 읽기’를 선택하세요. 한국어 Excel의 CSV는 대개 쉼표로 구분되지만, 탭으로 구분된 텍스트 파일이나 유럽에서 받은 세미콜론 구분·소수점 쉼표 파일도 문제없이 열립니다. 이때 19,90 같은 숫자는 텍스트로 그대로 유지됩니다.

“…번째 줄에서 시작한 따옴표 값이 닫히지 않았습니다”라고 나올 때

메시지에 표시된 줄부터 큰따옴표 하나가 빠져 있습니다. 가능하면 파일을 고치세요. 그래도 내용을 보려면 ‘가져오기 설정’에서 ‘큰따옴표를 CSV 인용 부호로 처리’를 끄세요. 그러면 따옴표를 일반 문자로 읽습니다. 붙여넣은 텍스트라면 메시지에 나오는 ‘따옴표를 텍스트로 처리해 열기’로 바로 열 수 있습니다.

붙여넣기

• 툴바 팝업에는 4,194,304자까지 붙여넣을 수 있습니다. 더 긴 텍스트는 ViewCSV 탭을 열고 ‘텍스트 붙여넣기’를 선택하세요(52,428,800자까지).
• 스프레드시트에서 복사한 행은 보통 탭으로 구분되며, ViewCSV가 이를 감지합니다.
• 빈 줄은 건너뛰고, 건너뛴 개수를 표 위의 알림으로 보여 줍니다.

‘표 찾기’에 아무것도 나오지 않거나 보이는 표와 다를 때

• 실제 HTML 표만 찾습니다. 많은 사이트가 다른 요소로 표 모양을 만들며, 이런 표는 읽을 수 없습니다. 텍스트를 복사해 붙여넣거나 사이트에 CSV 다운로드 기능이 있는지 확인하세요.
• 다른 사이트의 프레임 안에 있는 표, 숨겨진 표, 셀이 하나뿐인 레이아웃용 표는 건너뜁니다. 목록에는 최대 50개까지 표시됩니다.
• 스크롤하거나 페이지를 넘길 때 행을 더 불러오는 페이지는 그 순간 페이지에 있는 행만 읽습니다.
• “표를 선택한 뒤 페이지의 표가 바뀌었습니다.” 또는 “ViewCSV가 더 이상 그 페이지를 읽을 수 없습니다.”: 페이지가 새로 고쳐졌거나 바뀌었습니다. 페이지로 돌아가 ‘표 찾기’를 다시 선택하세요.
• 병합된 셀은 나누어지고, 원래 범위의 모든 셀에 같은 값이 들어갑니다. 몇 개를 나눴는지 알림으로 알려 줍니다.

“ViewCSV는 이 페이지를 읽을 수 없습니다.”라고 나올 때

브라우저는 확장 프로그램이 브라우저 자체의 페이지(설정, 새 탭, 확장 프로그램 스토어)나 일부 보호된 페이지를 읽지 못하게 합니다. 탭에서 연 컴퓨터의 파일도 읽을 수 없으니 ViewCSV 탭에서 ‘파일 선택’으로 여세요.

CSV 링크가 열리지 않을 때

• 접근을 허용하지 않은 경우: ‘허용하고 열기’를 다시 선택하고, 그 사이트에 대한 브라우저의 질문에서 허용하세요.
• “이 링크는 다른 주소로 리디렉션되며…”: ViewCSV는 리디렉션을 따라가지 않습니다. 브라우저에서 링크를 열어 최종 주소를 사용하거나 파일을 다운로드하세요.
• “이 사이트는 로그인이 필요합니다”(오류 401 또는 403): ViewCSV는 로그인 정보를 보내지 않습니다. 대신 브라우저에서 파일을 내려받으세요.
• “링크에서 CSV 파일이 아닌 웹페이지가 열렸습니다.”: 링크가 파일이 아니라 로그인 페이지나 다운로드 안내 페이지로 연결됩니다.
• 파일이 너무 크거나 60초보다 오래 걸리는 경우, 링크에 사용자 이름이나 비밀번호가 있는 경우, 사용자 네트워크 안의 주소인 경우: 다운로드를 거부합니다.
• 어떤 경우든 브라우저로 파일을 내려받은 뒤 ‘파일 선택’으로 열 수 있습니다.

내보내기

• 내보낸 파일은 UTF-8입니다. Excel에서 한글이 깨지면 ‘UTF-8 BOM 포함’ 옵션을 켜세요(기본으로 켜져 있음).
• CSV로 내보낼 때는 기본적으로 원본 파일의 구분 기호를 사용하며, ‘내보내기’ 창에서 다른 구분 기호를 고를 수 있습니다. 값은 서식을 바꾸지 않고 그대로 씁니다.
• ‘스프레드시트 수식으로 실행되지 않도록 보호’(기본으로 켜짐)는 =, +, -, @(또는 전각 ＝ ＋ － ＠, 탭, 캐리지 리턴)로 시작하면서 단순한 숫자가 아닌 셀 앞에 아포스트로피(')를 붙여, 스프레드시트가 실행하지 않고 텍스트로 표시하게 합니다. 데이터베이스에 불러올 때처럼 원래 텍스트가 그대로 필요하면 끄세요.
• JSON은 모든 값이 문자열인 객체 배열로 내보냅니다. 이름이 없는 열은 “Column N”이 되고, 중복된 이름에는 “(2)”, “(3)”이 붙습니다.
• 화면에 보이는 행(검색·필터 적용 후, 현재 순서)과 전체 행 중에서 고를 수 있고, 숨긴 열을 제외할 수도 있습니다.
• 209,715,200바이트(200 MB)를 넘는 내보내기는 거부됩니다. 먼저 행을 필터링하거나 열을 숨기세요.

원본 파일과 저장하지 않은 변경 내용

ViewCSV는 원본 파일이나 웹페이지를 바꾸지 않습니다. 편집한 셀, 삭제한 행, 바꾼 열 이름은 내보내기 전까지 ViewCSV 탭에만 있으며, 실행 취소로 최근 200개의 변경을 되돌릴 수 있습니다. 정렬, 검색, 필터는 보이는 방식만 바꿉니다. 탭을 닫거나 새로 고치면 변경 내용이 사라지고(브라우저가 먼저 확인합니다), ‘가져오기 설정’을 바꾸면 데이터를 다시 읽으므로 이때도 사라집니다.

숫자 열이 텍스트처럼 정렬될 때

숫자는 1234.5나 -0.75처럼 소수점이 점인 단순한 십진수일 때만 인식합니다. 18,900 같은 천 단위 쉼표, 18,900원이나 ₩ 같은 통화 표기, 소수점 쉼표, 지수 표기, 날짜는 텍스트이며, 앞자리가 0인 값이 있는 열(우편번호, 주문번호 등)은 일부러 텍스트로 처리합니다. 텍스트는 자연 정렬되므로 2가 10보다 앞에 옵니다.