위치 이동
현재 위치 확인
pwd
pwd뜻
터미널이 현재 작업 중인 폴더의 절대 경로를 출력합니다.
언제 쓰나
프로젝트 폴더 안에서 실행해야 하는 명령을 쓰기 전에 현재 위치를 확인할 때 사용합니다.
예시
pwd요청 예시
터미널이 현재 어느 폴더에 있는지 확인해줘.
프로그래밍
주요 터미널 명령어
웹 프로젝트를 수정, 실행, 테스트, 디버깅할 때 자주 쓰는 터미널 명령어를 검색하고 용도와 주의점을 확인하는 가이드입니다.
33 개 명령어
위치 이동
파일 목록 보기
ls
ls뜻
현재 폴더 안의 파일과 폴더 목록을 보여줍니다.
언제 쓰나
package.json, src, next.config.mjs 같은 예상 파일이 있는지 확인할 때 사용합니다.
예시
ls요청 예시
현재 프로젝트 폴더의 파일 목록을 보여줘.
위치 이동
폴더 이동
cd
cd ~/projects/my-web-app뜻
터미널의 작업 위치를 다른 폴더로 이동합니다.
언제 쓰나
npm run build처럼 프로젝트 폴더에서 실행해야 하는 명령 전에 사용합니다.
주의
명령 자체가 맞아도 잘못된 폴더에서 실행하면 실패할 수 있습니다.
예시
cd ~/projects/my-web-app요청 예시
명령을 실행하기 전에 프로젝트 폴더로 이동해줘.
위치 이동
화면 정리
clear
clear뜻
파일이나 명령 기록은 바꾸지 않고 보이는 터미널 출력만 정리합니다.
언제 쓰나
이전 출력이 많아 헷갈릴 때 새 명령을 다시 실행하기 전에 사용합니다.
예시
clear요청 예시
빌드를 다시 실행하기 전에 터미널 화면을 정리해줘.
파일과 폴더
파일 내용 보기
cat
cat package.json뜻
파일 내용을 터미널에 출력합니다.
언제 쓰나
package.json, 설정 파일, 짧은 텍스트 파일 내용을 빠르게 볼 때 사용합니다.
주의
매우 큰 파일은 전부 출력하지 말고 sed, rg, pager 같은 방식을 쓰는 편이 낫습니다.
예시
cat package.json요청 예시
package.json의 scripts를 보여줘.
파일과 폴더
특정 줄 보기
sed
sed -n '1,120p' src/components/SiteHeader.tsx뜻
파일에서 선택한 줄 범위만 출력할 수 있습니다.
언제 쓰나
전체 파일을 열지 않고 필요한 코드 구간만 확인할 때 사용합니다.
예시
sed -n '1,120p' src/components/SiteHeader.tsx요청 예시
SiteHeader.tsx의 처음 120줄을 보여줘.
파일과 폴더
폴더 만들기
mkdir
mkdir -p src/app/[locale]/reference/terminal-commands뜻
새 폴더를 만듭니다. -p 옵션은 필요한 상위 폴더도 만들고 이미 있어도 실패하지 않게 합니다.
언제 쓰나
새 페이지 폴더나 asset 폴더를 추가하기 전에 사용합니다.
예시
mkdir -p src/app/[locale]/reference/terminal-commands요청 예시
터미널 명령어 페이지 라우트 폴더를 만들어줘.
파일과 폴더
파일 복사
cp
cp .env.example .env.local뜻
파일이나 폴더를 다른 위치로 복사합니다.
언제 쓰나
예시 설정 파일을 로컬 설정으로 만들거나 템플릿을 복제할 때 사용합니다.
주의
대상 파일이 이미 있으면 덮어쓸 수 있습니다.
예시
cp .env.example .env.local요청 예시
로컬 설정을 덮어쓰지 않는 경우에만 예시 env 파일을 복사해줘.
파일과 폴더
이동 또는 이름 변경
mv
mv old-name.ts new-name.ts뜻
파일이나 폴더를 이동하거나 같은 폴더 안에서는 이름을 변경합니다.
언제 쓰나
파일명, 라우트 폴더명, asset 위치를 바꿀 때 사용합니다.
주의
라우트 폴더명을 바꾸면 URL도 바뀝니다.
예시
mv old-name.ts new-name.ts요청 예시
이 파일 이름을 바꾸고 필요하면 import도 수정해줘.
안전 작업
파일 삭제
rm
rm unused-file.ts뜻
파일을 삭제합니다. -r 옵션을 붙이면 폴더를 재귀적으로 삭제할 수 있습니다.
언제 쓰나
파일을 프로젝트에서 의도적으로 제거할 때만 사용합니다.
주의
rm은 파괴적입니다. 실행 전에 경로를 반드시 확인해야 합니다.
예시
rm unused-file.ts요청 예시
이 파일을 삭제하기 전에 무엇이 제거되는지 설명해줘.
검색과 확인
빠른 텍스트 검색
rg
rg -n "errorMessageGuide" src뜻
여러 파일에서 텍스트를 빠르게 검색합니다.
언제 쓰나
수정 전에 import, 컴포넌트, slug, CSS class, 예전 이름을 찾을 때 사용합니다.
예시
rg -n "errorMessageGuide" src요청 예시
이 컴포넌트가 어디서 import되는지 검색해줘.
검색과 확인
파일 경로 빠르게 나열
rg --files
rg --files src/app뜻
일반적인 ignore 규칙을 따르면서 파일 경로를 빠르게 나열합니다.
언제 쓰나
빌드 결과물을 훑지 않고 page 파일, 컴포넌트, lib 파일을 찾을 때 사용합니다.
예시
rg --files src/app요청 예시
src/app 아래 참고 페이지 파일을 나열해줘.
검색과 확인
경로 찾기
find
find src -name 'page.tsx'뜻
파일 시스템에서 경로, 이름, 파일 속성 기준으로 찾습니다.
언제 쓰나
파일 내용이 아니라 파일명 패턴으로 찾을 때 사용합니다.
예시
find src -name 'page.tsx'요청 예시
모든 page.tsx 라우트 파일을 찾아줘.
검색과 확인
줄/단어 수 세기
wc
wc -l src/lib/terminal-commands.ts뜻
줄 수, 단어 수, 바이트 수를 셉니다.
언제 쓰나
파일 크기를 가늠하거나 검색 결과 수를 셀 때 사용합니다.
예시
wc -l src/lib/terminal-commands.ts요청 예시
이 데이터 파일이 몇 줄인지 세어줘.
패키지
의존성 설치
npm install
npm install뜻
package.json과 package-lock.json에 적힌 패키지를 설치합니다.
언제 쓰나
프로젝트를 clone한 뒤나 의존성이 없을 때 사용합니다.
주의
의존성 버전 해석에 따라 package-lock.json이 바뀔 수 있습니다.
예시
npm install요청 예시
node_modules가 없을 때만 의존성을 설치해줘.
개발 서버
개발 서버 실행
npm run dev
npm run dev뜻
프로젝트의 로컬 개발 서버 스크립트를 실행합니다.
언제 쓰나
수정 중 브라우저에서 페이지를 확인할 때 사용합니다.
주의
개발 서버는 중지하기 전까지 터미널 세션을 계속 사용합니다.
예시
npm run dev요청 예시
개발 서버를 실행하고 로컬 URL을 알려줘.
패키지
프로덕션 빌드
npm run build
npm run build뜻
프로덕션 빌드 스크립트를 실행해 컴파일, 라우트, 타입 문제를 많이 잡아냅니다.
언제 쓰나
배포 전이나 새 페이지 추가 후 확인할 때 사용합니다.
예시
npm run build요청 예시
프로덕션 빌드를 실행하고 경고나 실패를 요약해줘.
패키지
린트 검사
npm run lint
npm run lint뜻
프로젝트의 lint 스크립트를 실행해 스타일과 정적 코드 문제를 찾습니다.
언제 쓰나
빌드 전에 빠르게 문제를 확인하고 싶을 때 사용합니다.
예시
npm run lint요청 예시
lint를 실행하고 조치가 필요한 오류만 보여줘.
패키지
Node 버전 확인
node -v
node -v뜻
설치된 Node.js 버전을 출력합니다.
언제 쓰나
프로젝트나 의존성이 특정 Node 버전을 요구할 때 확인합니다.
예시
node -v요청 예시
이 경고를 설명하기 전에 Node.js 버전을 확인해줘.
패키지
패키지 명령 실행
npx
npx next info뜻
설치된 또는 임시로 내려받은 npm 패키지의 명령을 실행합니다.
언제 쓰나
package script가 없는 일회성 도구 명령을 실행할 때 사용합니다.
주의
설치되어 있지 않은 패키지는 npx가 네트워크에서 내려받을 수 있습니다.
예시
npx next info요청 예시
이 npx 명령이 네트워크 접근을 필요로 하는지 설명해줘.
Git
Git 상태 확인
git status
git status --short뜻
현재 브랜치와 수정, 스테이징, 미추적 파일을 보여줍니다.
언제 쓰나
수정, 커밋, pull, 브랜치 이동 전에 확인합니다.
예시
git status --short요청 예시
Git 상태를 확인하고 변경 파일을 요약해줘.
Git
코드 차이 보기
git diff
git diff -- src/components/SiteHeader.tsx뜻
변경된 파일의 줄 단위 차이를 보여줍니다.
언제 쓰나
커밋 전에 정확히 무엇이 바뀌었는지 검토할 때 사용합니다.
예시
git diff -- src/components/SiteHeader.tsx요청 예시
이번 작업의 diff를 검토해줘.
Git
커밋 이력 보기
git log
git log --oneline -5뜻
커밋 이력을 보여줍니다.
언제 쓰나
최근 작업을 보거나 확인할 커밋을 찾을 때 사용합니다.
예시
git log --oneline -5요청 예시
최근 커밋 5개를 보여줘.
Git
변경 스테이징
git add
git add src/lib/terminal-commands.ts뜻
다음 커밋에 포함할 변경사항을 선택합니다.
언제 쓰나
커밋 범위를 명확히 하려면 파일 경로를 지정합니다.
예시
git add src/lib/terminal-commands.ts요청 예시
터미널 명령어 페이지 관련 파일만 스테이징해줘.
Git
커밋 저장
git commit
git commit -m "Add terminal command reference"뜻
스테이징된 변경사항을 Git 이력에 기록합니다.
언제 쓰나
스테이징된 변경을 검토한 뒤 사용합니다.
예시
git commit -m "Add terminal command reference"요청 예시
스테이징된 변경을 명확한 메시지로 커밋해줘.
개발 서버
실행 중인 명령 중지
Ctrl+C
Press Ctrl+C in the dev server terminal뜻
터미널에서 실행 중인 명령을 중단합니다.
언제 쓰나
로컬 개발 서버를 끄거나 포트를 바꾸기 전에 사용합니다.
주의
명령이 실행 중인 터미널 세션에서 눌러야 합니다.
예시
Press Ctrl+C in the dev server terminal요청 예시
실행 중인 개발 서버를 꺼줘.
개발 서버
열린 파일/포트 확인
lsof
lsof -i :3001뜻
어떤 프로세스가 특정 포트를 사용 중인지 확인할 수 있습니다.
언제 쓰나
개발 서버가 EADDRINUSE로 실패할 때 사용합니다.
예시
lsof -i :3001요청 예시
3001 포트를 어떤 프로세스가 쓰는지 찾아줘.
개발 서버
프로세스 목록 보기
ps
ps aux뜻
실행 중인 프로세스 목록을 보여줍니다.
언제 쓰나
실행 중인 개발 도구, 서버, 백그라운드 프로세스를 확인할 때 사용합니다.
예시
ps aux요청 예시
Next.js 개발 서버가 아직 실행 중인지 확인해줘.
안전 작업
PID로 프로세스 종료
kill
kill 12345뜻
프로세스 ID를 지정해 프로세스를 종료하는 신호를 보냅니다.
언제 쓰나
일반 중단이 어렵고 서버가 계속 실행 중일 때 사용합니다.
주의
잘못된 프로세스를 종료하지 않도록 PID를 정확히 확인해야 합니다.
예시
kill 12345요청 예시
프로세스를 종료하기 전에 해당 PID가 무엇인지 보여줘.
네트워크
HTTP 요청 확인
curl
curl -I http://localhost:3001/ko뜻
터미널에서 HTTP 요청을 보내고 응답을 출력합니다.
언제 쓰나
로컬 또는 배포 URL이 200, 404, 500, redirect 중 무엇으로 응답하는지 확인할 때 사용합니다.
예시
curl -I http://localhost:3001/ko요청 예시
curl로 이 페이지가 200을 반환하는지 확인해줘.
네트워크
네트워크 연결 확인
ping
ping 172.30.1.55뜻
호스트가 기본 네트워크 패킷에 응답하는지 확인합니다.
언제 쓰나
웹앱 상태 확인이 아니라 대략적인 네트워크 도달성 확인으로 사용합니다.
예시
ping 172.30.1.55요청 예시
이 기기가 개발 머신 IP에 도달할 수 있는지 확인해줘.
검색과 확인
명령 실행 파일 위치 확인
which
which node뜻
명령 이름을 실행할 때 어떤 실행 파일이 사용되는지 보여줍니다.
언제 쓰나
한 컴퓨터에 여러 Node, npm, 도구 버전이 있을 수 있을 때 확인합니다.
예시
which node요청 예시
어떤 node 실행 파일이 사용되는지 확인해줘.
안전 작업
파일 권한 변경
chmod
chmod +x script.sh뜻
파일의 읽기, 쓰기, 실행 권한을 변경합니다.
언제 쓰나
로컬 스크립트를 실행 가능하게 만들어야 할 때 사용합니다.
주의
chmod -R 777 같은 넓은 권한 변경은 피해야 합니다.
예시
chmod +x script.sh요청 예시
이 스크립트에 필요한 가장 안전한 권한 변경을 설명해줘.