TeXstudio는 Windows, macOS 및 Linux를 위한 무료 오픈 소스 LaTeX IDE입니다. Editor, PDF 뷰어, 빌드 구성 및 완료가 하나의 창에 표시되며 별도로 설치하는 TeX 배포판(예: TeX Live)을 구동합니다. 이 페이지에서는 실제로 가장 중요한 세 가지 사항, 즉 사람들이 계속 고민하는 빌드 구성, 쓰기 속도를 높이는 완료, 소스와 PDF 사이를 이동하기 위한 SyncTeX에 중점을 둡니다.
TeXstudio가 무엇인가요?
TeXstudio는 이전 Texmaker 코드베이스의 포크로 시작된 전용 LaTeX 편집기입니다. Benito van der Zander와 다른 사람들은 2009년에 "TexMakerX"로 시작하여 2011년에 TeXstudio로 이름을 바꿨습니다. Qt를 기반으로 구축된 이 편집기는 세 운영 체제에서 거의 동일하게 보이고 작동하며 구문 강조, 실시간 철자 및 문법 검사, 팔레트를 제공합니다. 1000개 이상의 수학 기호 및 내장된 PDF 뷰어. LaTeX 자체는 번들로 제공되지 않습니다. 컴파일은 시스템에 이미 설치된 pdflatex 또는 latexmk와 같은 TeXstudio 실행 명령을 사용하여 작동합니다.
따라서 설치 순서가 중요합니다. 먼저 TeX 배포판을 설치한 다음 TeXstudio를 설치하십시오. 작업 설정이 완료되면(예: TeX Live 2026) TeXstudio 측에 남아 있는 것은 문서 작성 방법을 연결하는 것뿐입니다.
빌드 구성
모든 설정은 옵션 → TeXstudio 구성에 있습니다. 하단의 “고급 옵션 표시”를 선택하면 더 많은 항목이 표시됩니다. 두 개의 탭이 빌드를 관리합니다. Build 탭은 어떤 명령이 기본값인지 결정하고 Commands 탭은 각 명령이 실제로 무엇인지, 즉 실행 파일의 경로와 해당 인수를 지정합니다.
일상적인 사용에는 버튼 두 개만 있으면 됩니다. 빌드 및 보기(F5)는 PDF를 컴파일한 후 엽니다. 컴파일(F6)은 PDF를 생성합니다. 그 외에도 View(F7)는 PDF를 열고 Clean은 .aux 및 .toc와 같은 중간 파일을 제거합니다.
내부적으로 각 작업은 txs:///로 시작하는 명령으로 표현됩니다. 예를 들어 txs:///compile는 "기본 컴파일러"이고, txs:///view는 "기본 뷰어"이며, txs:///latexmk는 latexmk입니다. "Build & View"는 단순히 | 파이프로 결합된 이러한 명령의 시퀀스입니다. 기본 컴파일러는 pdfLaTeX로 제공되지만 일반적으로 참고문헌, 색인, 재실행 횟수 등 종속성을 자동으로 처리하는 latexmk로 전환합니다.
다음과 같이 명령 탭에 latexmk 행을 작성하면 PDF가 직접 생성되고 동시에 SyncTeX 정보가 방출됩니다. %는 처리 중인 파일로 확장됩니다(확장자 없음).
latexmk -pdf -synctex=1 -interaction=nonstopmode %.tex문서별로 엔진을 전환하려는 경우 첫 번째 줄의 마법의 주석이 이를 수행합니다. 예를 들어 아래 한 줄은 해당 문서를 LuaLaTeX로 컴파일하도록 만듭니다.
% !TeX program = lualatex먼저 정지하도록 설정
TeXstudio는 많은 설정을 노출하므로 기본 컴파일러, 빌드 및 보기 체인, SyncTeX 활성화 여부 등 세 가지만 고정하여 시작하는 것이 더 쉽습니다. 일단 해결되면 F5를 누르면 매번 같은 경로를 따릅니다.
- 대부분 서양 문서의 경우 latexmk를 사용하여 PDF를 직접 생성합니다. 상속된 일본어 템플릿의 경우 upLaTeX + dvipdfmx를 선택합니다.
- 컴파일 및 내부 뷰어 열기를 모두 포함하여 빌드 및 보기를 일상적인 F5 키의 동작으로 처리합니다.
- 명령에
-synctex=1및-file-line-error를 포함하면 PDF에서 소스로 다시 점프하고 파일 및 줄별로 오류를 읽을 수 있습니다. - 논문 본문을 열기 전에 10줄
.tex파일에서 설정을 테스트하고 로그와 PDF를 모두 검사하세요.
일본어용 빌드 구성
일본어에는 두 가지 접근 방식이 널리 사용됩니다. 하나는 LuaLaTeX입니다. Build 탭에서 Build & View를 “Compile & View”로 설정하고 기본 컴파일러를 “LuaLaTeX”로 설정한 후 F5 키를 한 번 누르면 PDF로 이동합니다. 새로운 시작을 위해서는 이것이 간단한 선택입니다. 다른 하나는 upLaTeX + dvipdfmx이며, 일본어의 표준입니다. 여기서 Build & View를 “DVI->PDF 체인”으로 설정하고 기본 컴파일러를 “LaTeX”로 설정합니다(PDF 이전에 DVI를 경유하기 때문입니다).
가장 깔끔한 배열은 .latexmkrc에서 엔진 조합을 설명하고 TeXstudio가 latexmk만 호출하도록 하는 것입니다. 다음 파일을 .tex와 동일한 폴더에 넣으면 latexmk가 upLaTeX → dvipdfmx 흐름, 참고문헌(upbibtex), 색인(upmendex) 및 재실행 횟수를 관리합니다. $latex에는 -synctex=1가 포함되어 있으므로 SyncTeX도 작동합니다.
$latex = 'uplatex %O -synctex=1 -interaction=nonstopmode %S';
$bibtex = 'upbibtex %O %B';
$makeindex = 'upmendex %O -o %D %S';
$dvipdf = 'dvipdfmx %O -o %D %S';
$pdf_mode = 3;여기서 $pdf_mode = 3는 "DVI를 만든 다음 $dvipdf를 사용하여 PDF로 전환" 모드를 선택합니다. 토큰 %O(추가 옵션), %S(소스 파일), %B(확장자가 없는 기본 이름) 및 %D(출력 대상)는 latexmk의 자리 표시자입니다. 이 접근 방식을 사용하면 TeXstudio, 명령줄 또는 다른 편집기에서 호출하더라도 동일한 결과를 얻을 수 있습니다. 구성은 한 곳에 있습니다.
첫 번째 오류의 로그 읽기
TeXstudio의 로그 패널은 오류를 진단하기에 좋은 장소입니다. 설정을 무작위로 변경하기 전에 먼저 어떤 명령이 실행되었는지, 로그의 첫 번째 오류는 무엇인지 물어보십시오. LaTeX 오류가 연속적으로 발생하므로 일반적으로 첫 번째 빨간색 줄이 마지막 줄보다 더 중요합니다.
Could not start the command가 보이면 TeXstudio를 비난하기 전에 PATH 또는 TeX Live / MiKTeX 설치를 의심하십시오.File not found의 경우 루트 파일, 상대 경로, 그림 파일 이름을 확인하세요.- 누락된 패키지의 경우 TeX Live의
tlmgr또는 MiKTeX의 MiKTeX Console를 사용하여 추가하세요. - 로그 줄 번호를 클릭하고 첫 번째 오류만 수정한 후 나머지 계단식 내용을 읽기 전에 다시 빌드하세요.
완성 및 구조보기
TeXstudio의 완성은 키 입력을 안정적으로 줄여줍니다. \ 다음에 문자를 입력하면 후보 명령 목록이 팝업되고 문자를 추가하면 범위가 좁아집니다. 여러 후보자가 공통 접두사를 공유하는 경우 Tab은 해당 공유 부분을 한 번에 채웁니다. 더 좋은 점은 상호 참조를 작성하면 \ref{...}는 문서에 있는 레이블을 제공하고, \cite{...}는 참고문헌 키(bibID)를 제공하므로 이름을 절반도 기억할 필요가 거의 없습니다.
환경도 함께 일하기 즐겁습니다. 하나를 시작하면(예: \begin{itemize}) 일치하는 \end{itemize}가 자동으로 삽입됩니다. 잠시 기존 환경 이름에 커서를 놓으면 미러 커서가 나타나서 \begin 및 \end의 이름을 동시에 다시 쓸 수 있습니다(한 번의 이동으로 itemize에서 enumerate로 변경). 아직 열려 있는 환경을 닫으려면 Alt+Return을 누르세요.
왼쪽의 구조 보기는 문서의 맵이 됩니다. 여기에는 제목(\section 및 친구), 레이블(\label), \input/\include를 통해 가져온 파일, 비머 블록 및 TODO(\todo{} 또는 % TODO 주석)가 나열됩니다. 항목을 클릭하면 해당 지점으로 이동합니다. 긴 원고나 여러 파일로 구성된 프로젝트에서도 전체를 볼 수 있습니다.
SyncTeX(정방향 및 역방향 검색)
SyncTeX는 소스 라인을 PDF의 위치와 그 반대로 매핑합니다. 작동하면 정방향 검색(편집기의 줄에서 PDF의 일치 위치로 점프) 및 역검색(PDF의 한 지점에서 해당 소스 줄로 뒤로 점프)이 가능합니다. 교정할 때 효과가 있습니다. "이 단락을 생성한 줄"에 대한 검색이 간단하게 사라집니다.
이를 가능하게 하는 두 가지 조건이 있습니다. 먼저 -synctex=1를 컴파일 명령에 전달하여 동기화 파일(.synctex.gz)이 생성됩니다. 위의 latexmk 라인과 .latexmkrc는 이미 이 작업을 수행하고 있으며 잊어버린 경우 TeXstudio가 명령을 수정하도록 제안합니다. 둘째, 내부 PDF 뷰어에서 PDF를 엽니다. SyncTeX 지원은 양방향 점프를 가능하게 합니다.
제스처는 간단합니다. 뷰어가 열릴 때마다 정방향 검색이 자동으로 현재 커서 위치로 실행됩니다. 어디에서나 트리거하려면 소스에서 Ctrl + 왼쪽 버튼을 클릭하거나 컨텍스트 메뉴에서 “PDF로 이동”을 선택하세요. 역검색의 경우 PDF의 텍스트를 Ctrl + 왼쪽 버튼으로 클릭하거나 마우스 오른쪽 버튼 클릭 메뉴에서 “소스로 이동”을 선택하세요. "스크롤이 커서를 따라감" 및 "커서가 스크롤을 따라감"을 활성화하면 편집하는 동안 두 가지가 계속 연결된 상태로 유지됩니다.