Windows 개발환경 설치 가이드

0. 전체 개요 — 개발 환경 3층 구조

개발 환경은 보통 3개 층으로 쌓입니다. 아래 순서대로 설치하면 빠짐없이 갖춰집니다.

왜 이 순서인가? 런타임(②)이 있어야 라이브러리(③)를 설치할 수 있고, 도구(①)가 있어야 코드를 편하게 작성·관리할 수 있기 때문입니다. 아래로 갈수록 위층에 의존합니다.

1. 큰 그림 — 왜 이 프로그램들이 필요한가

"업무 자동화"는 결국 사람이 반복하던 일을 컴퓨터가 대신 실행하게 만드는 것입니다. 그러려면 ⓐ 명령을 적을 도구, ⓑ 명령을 실행할 엔진, ⓒ 실제 작업을 처리할 부품이 필요합니다.

• Git — 버전 관리. 코드의 변경 이력을 저장하고 언제든 되돌립니다. "실수해도 안전망"이 생깁니다.
• VS Code — 코드 편집기. 코드를 작성·실행·디버깅하는 작업실. 자동완성·터미널·확장 기능 제공.
• Node.js — JavaScript 실행 엔진. 웹 도구·서버·많은 CLI 프로그램이 이 위에서 돌아갑니다. npm이 함께 옵니다.
• Python — 자동화의 주력 언어. 엑셀·문서·웹·API·데이터 처리에 가장 라이브러리가 풍부합니다.

한 문장 요약: Git으로 안전하게 관리하고, VS Code에서 작성해서, Python/Node.js 엔진으로 실행하며, 라이브러리가 실제 작업(엑셀·웹·API)을 처리합니다.

2. Git 설치 & 설정

Git은 파일(특히 코드)의 변경 이력을 기록·관리하는 도구입니다. 문서의 "수정 기록"을 무한히 저장하는 타임머신이라고 생각하면 됩니다.

설치 단계

1. 다운로드 — git-scm.com/download/win 에서 Windows용 설치 파일을 받습니다. (또는 winget으로 winget install Git.Git)
2. 설치 실행 — 받은 .exe를 실행합니다. 옵션은 대부분 기본값(Next) 그대로 두면 됩니다.
3. 설치 확인 — 터미널(PowerShell)을 열고 아래를 입력해 버전이 나오면 성공입니다.

git --version
# 예: git version 2.54.0.windows.1

최초 1회 설정 — 사용자 정보

왜 설정하나? Git은 모든 변경(커밋)에 "누가 했는지" 작성자 이름·이메일을 기록합니다. 비어 있으면 커밋이 거부되거나 작성자가 빈 채로 남습니다. 최초 1회만 하면 됩니다.

git config --global user.name "사용자이름"
git config --global user.email "이메일주소"

# 설정 확인
git config --global user.name
git config --global user.email

--global은 "이 PC의 모든 프로젝트에 적용"이라는 뜻입니다. 설정은 C:\Users\사용자\.gitconfig 파일에 저장됩니다.

참고: GitHub 연동은 필수가 아닙니다. 위 설정만으로 로컬 버전 관리는 완전히 가능합니다. 클라우드에 백업·공유·협업할 때만 나중에 gh auth login(GitHub CLI)으로 연동하면 됩니다.

Git 기본 사용 흐름 (맛보기)

cd 프로젝트폴더
git init                 # 이 폴더를 Git으로 관리 시작
git add .                # 변경된 파일을 기록 대상으로 올림
git commit -m "첫 커밋"   # 현재 상태를 이력으로 저장
git log                  # 저장된 이력 보기

3. 핵심 런타임 — Node.js & Python

코드는 그 자체로는 글자일 뿐이고, 실행해 줄 엔진(런타임)이 있어야 동작합니다. 자동화·개발에서 가장 널리 쓰이는 두 엔진을 설치합니다.

Node.js + npm

왜 필요한가? 직접 JavaScript를 안 짜더라도, Playwright·각종 빌드 도구·웹 관련 프로그램들이 Node.js를 요구하는 경우가 매우 많습니다. "개발 환경의 공통 인프라"에 가깝습니다. LTS(장기 지원) 버전을 설치하세요.

winget install OpenJS.NodeJS.LTS
# npm은 Node.js에 함께 설치됩니다 (따로 설치 X)

Python (자동화 핵심)

Python은 업무 자동화에서 가장 강력한 언어입니다. 문법이 쉽고, 엑셀·문서·웹·데이터·AI까지 라이브러리 생태계가 압도적입니다.

winget install Python.Python.3.12

흔한 함정 — Python 버전 혼재. 윈도우에는 Microsoft Store판 등 여러 Python이 섞이기 쉽습니다. 여러 개가 깔려 있으면 어떤 게 실행될지 헷갈립니다. 해결책: 항상 버전을 명시해서 실행하세요.

py -3.12 script.py          # 3.12로 확실하게 실행
py -0p                       # 설치된 Python 목록 + 경로 보기

4. winget으로 한 번에 설치하기

winget은 Windows에 기본 내장된 공식 패키지 관리자입니다. 웹사이트를 찾아다니며 일일이 다운로드할 필요 없이, 명령어 한 줄로 프로그램을 설치·업데이트합니다.

왜 winget을 쓰나? ① 설치가 빠르고 자동화됨 ② 항상 최신·정품 출처 ③ 나중에 업데이트도 winget upgrade 한 줄. 새 PC 세팅이 몇 분으로 줄어듭니다.

토대 3종 — 복사해서 순서대로 실행

# PowerShell에서 실행 (관리자 권한 승인창이 뜨면 "예")
winget install OpenJS.NodeJS.LTS           # Node.js + npm
winget install Python.Python.3.12          # Python
winget install Microsoft.VisualStudioCode  # VS Code 편집기

VS Code

VS Code는 무료 코드 편집기로, 사실상 표준입니다. 코드 작성·실행·디버깅·터미널·Git 연동이 한 화면에서 됩니다.

추천 확장: 설치 후 VS Code에서 Python(Microsoft), Pylance 확장을 추가하면 Python 자동화 작업이 훨씬 편해집니다.

5. 자동화 라이브러리 설치 (pip)

런타임이 "엔진"이라면, 라이브러리는 특정 작업을 대신 처리해주는 부품입니다. Python은 pip으로 설치합니다.

설치 명령

# 1) pip 자체를 최신으로
py -3.12 -m pip install --upgrade pip

# 2) 라이브러리 한 번에 설치
py -3.12 -m pip install pandas openpyxl python-docx python-pptx pypdf requests httpx playwright

# 3) Playwright용 브라우저 내려받기 (웹 자동화에 필수)
py -3.12 -m playwright install chromium

왜 py -3.12 -m pip 형태로? Python이 여러 개일 때 "정확히 3.12에" 설치하기 위함입니다. 그냥 pip install은 엉뚱한 버전에 깔릴 수 있습니다.

6. 정기 실행 — 윈도우 작업 스케줄러

"매일 아침 9시 자동 실행"처럼 정해진 시간에 스크립트를 자동 실행하려면 별도 프로그램이 필요 없습니다. 윈도우에 내장된 작업 스케줄러(Task Scheduler)를 쓰면 됩니다.

1. 작업 스케줄러 열기 — 시작 메뉴에서 "작업 스케줄러" 검색 후 실행
2. 기본 작업 만들기 — 우측 "기본 작업 만들기" 클릭, 이름 입력
3. 트리거 설정 — "매일" 등 원하는 주기와 시각 선택
4. 동작 설정 — "프로그램 시작" 선택 후 — 프로그램/스크립트: py, 인수: -3.12 "C:\경로\스크립트.py"
5. 완료 — 설정한 시간에 자동으로 실행됩니다

왜 내장 스케줄러인가? 추가 설치가 없고, PC가 켜져 있으면 가장 안정적으로 동작합니다. 별도 자동화 프로그램보다 단순하고 견고합니다.

7. 설치 검증 — 제대로 깔렸나 확인

설치 후 새 터미널을 열고 아래를 실행하세요. 버전이 출력되면 정상입니다.

git --version              # Git
node --version             # Node.js
npm --version              # npm
py -3.12 --version         # Python
py -3.12 -m pip --version  # pip
code --version             # VS Code

방금 설치했는데 명령을 못 찾는다면? 터미널(또는 VS Code)을 완전히 닫았다 다시 여세요. 설치 직후에는 PATH(프로그램 위치 목록)가 기존 터미널에 반영되지 않습니다. 재시작하면 해결됩니다.

8. 자주 쓰는 명령어 + 설치 체크리스트

명령어 모음

# winget
winget install <ID>     # 설치
winget upgrade --all    # 전체 업데이트
winget list             # 설치 목록
winget search 이름       # 검색

# Git
git status              # 현재 상태
git add .               # 변경 올리기
git commit -m "메시지"
git log                 # 이력

# Python
py -0p                  # 버전 목록
py -3.12 파일.py         # 실행
py -3.12 -m pip list    # 설치된 라이브러리

# npm
npm install 패키지       # 설치
npm list -g             # 전역 목록
npm update              # 업데이트

설치 체크리스트