2026/05 (40)


venv vs uv, 뭘 써야 할까? — Python 가상환경 도구 비교

venv vs uv, 뭘 써야 할까? — Python 가상환경 도구 비교

Python 가상환경 도구로 기본 내장 venv를 쓰는 분도 있고 요즘 뜨고 있는 uv를 쓰는 분도 있어요. 둘 다 써본 입장에서 뭐가 다르고 어떤 상황에 뭘 쓰면 좋은지 비교해봤습니다.이 글은 이런 분을 위해 쓴 거예요1) venv를 쓰고 있는데 uv라는 걸 들어봤고 뭐가 다른지 궁금한 분2) 둘 중 뭘 써야 할지 결정하고 싶은 분3) 가상환경 개념은 알고 있으면 바로 읽을 수 있어요각 도구에 대해 자세히 알고 싶은 분이라면 먼저 아래의 글을 읽고 오시면 이해가 더 쉬워요!Python 가상환경(venv), 왜 다들 쓰라고 하는지 드디어 이해했다!uv 입문 가이드 - pip보다 빠른 Python 패키지 매니저목차한눈에 비교표같은 작업, 다른 명령어체감 차이가 큰 3가지각각의 단점어떤 걸 쓸까?1. 한눈에..

Git 브랜치 전략, 혼자 개발해도 이건 알아야 합니다

Git 브랜치 전략, 혼자 개발해도 이건 알아야 합니다

Git으로 혼자 개발할 때 main 브랜치에 바로 커밋하시나요? 그래도 돌아가긴 하는데 코드가 꼬이거나 "아까 그 버전으로 돌아가고 싶다"는 순간이 오면 후회하게 됩니다.브랜치를 쓰면 이런 문제가 거의 사라져요. 팀 프로젝트뿐 아니라 혼자 할 때도 브랜치 전략을 쓰면 훨씬 편합니다. 최소한으로 필요한 것만 정리해봤습니다.이 글은 이런 분을 위해 쓴 거예요1) git add, git commit 정도는 써봤지만 브랜치는 처음이거나 어렵게 느껴지는 분2) 혼자 프로젝트를 하면서 코드 관리를 좀 더 체계적으로 하고 싶은 분Git 자체를 처음 접하는 분이라면 먼저 아래의 글을 읽고 오시면 이해가 더 쉬워요![개발/개발환경] - Git 기초 사용법 - init, add, commit부터 시작하기 Git 기초 사용..

GitHub 처음 쓰는 사람을 위한 가이드 - push, pull, clone

GitHub 처음 쓰는 사람을 위한 가이드 - push, pull, clone

우선 Git 기초(init, add, commit)가 아직 어렵다면 아래의 글이 도움이 될거예요![개발/개발환경] - Git 기초 사용법 - init, add, commit부터 시작하기 Git 기초 사용법 - init, add, commit부터 시작하기코드를 짜다가 "아 아까 그 버전으로 돌아가고 싶다"고 생각한 적 있나요? 또는 파일을 수정하다가 망쳐서 최종.py, 최종_진짜최종.py, 최종_진짜진짜최종.py를 만들어본 적 있나요?Git을 쓰면 이런ldsjoy.tistory.comGit은 배웠는데 GitHub은 아직 안 써봤다면 이 글이 도움이 될거예요!Git으로 커밋까지는 하는데 "이걸 어떻게 GitHub에 올리지?" 하는 분들 많거든요. push, pull, clone — 이 세 가지만 알면 Git..

Git 기초 사용법 - init, add, commit부터 시작하기

Git 기초 사용법 - init, add, commit부터 시작하기

코드를 짜다가 "아 아까 그 버전으로 돌아가고 싶다"고 생각한 적 있나요? 또는 파일을 수정하다가 망쳐서 최종.py, 최종_진짜최종.py, 최종_진짜진짜최종.py를 만들어본 적 있나요?Git을 쓰면 이런 문제가 사라집니다. 코드의 변경 이력을 자동으로 기록해주는 도구예요.이 글은 이런 분을 위해 쓴 거예요1) Git을 처음 접하거나 이름만 들어봤지 써본 적 없는 분2) 터미널(명령어 입력 창)을 기본적으로 사용할 수 있는 분 (cd, ls 정도)3) 프로그래밍 언어는 무관해요. Python이든 JavaScript든 다 됩니다터미널이 처음이라면 아래의 글을 먼저 읽으시면 좋아요![개발/개발환경] - 터미널 명령어 20개로 끝내기 - 개발 시작 전에 이것만 알면 됩니다 터미널 명령어 20개로 끝내기 - 개발..

터미널 명령어 20개로 끝내기 - 개발 시작 전에 이것만 알면 됩니다

터미널 명령어 20개로 끝내기 - 개발 시작 전에 이것만 알면 됩니다

코딩을 배우기 시작하면 언젠가 반드시 만나게 되는 검은 화면... 터미널!!처음 보면 해커 영화에 나오는 것 같아서 겁부터 나는데 사실 자주 쓰는 명령어는 몇 개 안 돼요. 오늘 이 글에서 20개만 알려드릴 테니 이것만 기억하면 터미널이 편해집니다.이 글은 이런 분을 위해 쓴 거예요1) 터미널(검은 화면)을 처음 열어보는 완전 초보자2) 개발 공부를 시작했는데 명령어가 하나도 안 외워지는 분목차터미널이 뭔가요?터미널 여는 법폴더 이동 — cd, pwd, ls파일/폴더 만들기 삭제 — mkdir, touch, rm, rmdir파일 내용 보기 복사 이동 — cat, cp, mv기타 유용한 명령어 — clear, history, which, echo, grep20개 명령어 총정리 표✳️ 터미널이 뭔가요?우리가..

CORS 에러 해결법 — "왜 API가 브라우저에서만 안 되지?"

CORS 에러 해결법 — "왜 API가 브라우저에서만 안 되지?"

프론트엔드 코드에서 API를 호출했는데 갑자기 빨간 에러가 뜨면서 요청이 실패한 경험 있으신가요? Postman이나 터미널에서는 잘 되는데 브라우저에서만 안 되는 그 에러. 바로 CORS 에러예요.처음 만나면 정말 당황스러운데 원리를 알면 해결은 어렵지 않아요.이 글에서 CORS가 뭔지부터 해결법까지 한 번에 정리해드릴게요.이 글은 이런 분을 위해 쓴 거예요1) 프론트엔드에서 API 호출했는데 CORS 에러가 나서 막힌 분2) "Access-Control-Allow-Origin" 에러 메시지를 처음 본 분3) 프론트엔드+백엔드 기본 구조를 알고 fetch나 axios로 API를 호출해본 적 있으면 따라할 수 있어요HTTP가 뭔지부터 알고 싶다면 아래의 글을 먼저 읽어보세요![개발/개발환경] - 개발자가 ..

pip install 에러 총정리 - 설치가 안 될 때 이것부터 확인하세요

pip install 에러 총정리 - 설치가 안 될 때 이것부터 확인하세요

Python을 배우기 시작하면 pip install로 패키지를 설치하는 일이 정말 많아요. 그런데 이게 한 번에 깔끔하게 설치되는 경우보다 빨간 에러 메시지를 만나는 경우가 더 많거든요.이 글에서는 pip install에서 자주 만나는 에러 7가지를 정리했어요. 에러 메시지 원문 → 원인 → 해결 순서로 하나씩 알려드릴게요.목차pip이 뭔지 한 줄 복습pip: command not foundPermission deniedCould not find a version that satisfiesERROR: Could not build wheelConnection timed out / SSLErrorDEPRECATION 경고에러별 해결 요약 표1. pip이 뭔지 한 줄 복습pip은 Python 패키지를 설치하고..

.env 파일과 API 키 관리 완전 정리 - 한번 세팅하면 계속 쓰는 기본기

.env 파일과 API 키 관리 완전 정리 - 한번 세팅하면 계속 쓰는 기본기

코딩하다 보면 API 키, DB 비밀번호, 시크릿 토큰 같은 민감한 정보를 코드에 넣어야 할 때가 있습니다. 그런데 이걸 코드에 직접 적어놓으면? GitHub에 올린 순간 전 세계에 공개됩니다.실제로 GitHub에 AWS 키를 실수로 올렸다가 몇 분 만에 해킹당해서 수백만 원 과금된 사례도 있어요. 이런 사고를 방지하는 가장 기본적인 방법이 .env 파일입니다.이 글은 이런 분을 위해 쓴 거예요1) API 키를 코드에 직접 적어놓고 있는 분2) .env 파일이 뭔지는 알겠는데 정확히 어떻게 쓰는지 모르겠는 분3) Git과 Python/Node.js 기본 사용이 가능한 분목차환경변수가 뭔가요.env 파일이란Python에서 .env 사용하기Node.js에서 .env 사용하기.gitignore 설정 (필수!)..

uv 입문 가이드 - pip보다 빠른 Python 패키지 매니저

uv 입문 가이드 - pip보다 빠른 Python 패키지 매니저

Python 패키지 설치할 때 pip install이 느려서 답답했던 적 있나요?가상환경 만들고 > requirements.txt 관리하고 > Python 버전까지 따로 pyenv로 관리하고...이 모든 걸 하나의 도구로 해결할 수 있습니다!uv는 Rust로 만든 Python 패키지 매니저인데 pip 대비 10~100배 빠르고 가상환경 + Python 버전 관리까지 한번에 해줘요.이 글은 이런 분을 위해 쓴 거예요1) Python을 쓰고 있는데 pip가 느리거나 환경 관리가 귀찮았던 분2) pip, venv, pyenv를 따로따로 쓰는 게 복잡하다고 느끼는 분3) 터미널에서 pip install을 해본 적 있으면 따라할 수 있어요목차uv가 뭔가요?뭘 대체할 수 있는지설치하기기본 사용법프로젝트에서 쓰기pi..

AGENTS.md / CLAUDE.md / GEMINI.md 작성 가이드 — AI 에이전트에게 프로젝트 규칙을 알려주는 법

AGENTS.md / CLAUDE.md / GEMINI.md 작성 가이드 — AI 에이전트에게 프로젝트 규칙을 알려주는 법

AI 코딩 에이전트를 쓸 때 매번 "이 프로젝트는 TypeScript야", "컨벤션은 camelCase야"라고 반복해서 알려주고 있나요?규칙 파일 하나만 만들어두면 에이전트가 알아서 참고합니다. 프로젝트 루트에 파일 하나 넣으면 끝이에요.문제는 도구마다 파일 이름이 다르다는 겁니다:도구규칙 파일Claude CodeCLAUDE.mdCodexAGENTS.mdGemini CLI / Antigravity CLIGEMINI.mdCursor.cursor/rules/*.mdcCline.clinerules이 글에서는 가장 많이 쓰이는 3개(CLAUDE.md, AGENTS.md, GEMINI.md)의 작성법을 실전 예시와 함께 정리합니다.이 글은 2026년 5월 기준으로 작성되었습니다.이 글은 이런 분을 위해 쓴 거예요..