통합 터미널
ProjectHub에는 프로젝트 디렉토리에서 바로 실행되는 통합 터미널이 내장되어 있습니다. 별도의 터미널 앱을 열지 않고도 명령어를 실행할 수 있습니다.
개요
통합 터미널은 xterm.js 5.x 기반으로 구현되어 있으며, macOS의 PTY(Pseudo-Terminal)를 통해 실제 셸(zsh/bash)과 연결됩니다.
주요 특징
| 특징 | 설명 |
|---|---|
| 한국어 완벽 지원 | 자모(Jamo) 조합 + 완성형 한글 입력 지원 |
| ANSI 컬러 | 256색 + 트루컬러 지원 |
| 링크 감지 | URL 자동 감지 및 클릭 가능 |
| 스크롤백 | 10,000줄 스크롤 히스토리 |
| 자동 크기 조정 | 창 크기에 맞춰 터미널 크기 자동 조정 |
| 프로젝트 디렉토리 | 프로젝트 폴더에서 자동 시작 |
터미널 열기 & 닫기
토글 방법
- 단축키:
⌘T(가장 빠른 방법) - 헤더 버튼: 프로젝트 상세 뷰 헤더의 터미널 아이콘 클릭
- 탭: 탭 바에서 터미널 탭 클릭
크기 조정
터미널 패널과 메인 콘텐츠 영역 사이의 구분선을 드래그하여 터미널 높이를 조정할 수 있습니다.
글꼴 및 테마
글꼴 우선순위
터미널은 다음 순서로 사용 가능한 글꼴을 자동 선택합니다:
- D2Coding — 한국어 프로그래밍용 글꼴 (권장)
- MesloLGS NF — Nerd Font 패치 글꼴
- SF Mono — macOS 기본 모노스페이스
💡 최상의 한국어 지원을 위해 D2Coding 글꼴 설치를 권장합니다.
컬러 테마
VS Code 다크 테마를 기반으로 한 컬러 스킴이 적용되어 있습니다:
- 배경: 진한 회색 (
#1E1E1E) - 전경: 밝은 회색 (
#D4D4D4) - ANSI 16색 + 확장 256색 지원
- 커서: 흰색 블록
한국어 입력
통합 터미널은 한국어 입력을 완벽하게 지원합니다:
- IME 조합 — 자모 조합 중인 텍스트가 올바르게 표시됩니다
- 완성형 한글 — 조합이 완료된 한글이 정상적으로 입력됩니다
- Base64 인코딩 — 유니코드 안전성을 위해 내부적으로 Base64 인코딩을 사용합니다
💡 한국어 파일명, 한국어 출력, 한국어 입력이 모두 정상적으로 동작합니다.
시스템 터미널에서 열기
현재 프로젝트 디렉토리를 macOS의 기본 Terminal.app에서 열 수 있습니다:
- 터미널 툴바의 시스템 터미널 버튼 클릭
- Terminal.app이 열리고 프로젝트 디렉토리로 자동 이동
💡 복잡한 작업이나 여러 터미널이 필요한 경우 시스템 터미널에서 작업하는 것이 편리합니다.
터미널 재시작
터미널이 응답하지 않거나 새로운 환경 변수를 적용해야 할 때:
- 터미널 툴바의 재시작 버튼 클릭
- 기존 셸 프로세스가 종료됩니다
- 새 셸이 프로젝트 디렉토리에서 시작됩니다