3D 프린팅 G-code 용어집 — 실무 용어와 예제

이 용어집이 설명하는 것

G-code 파일에는 명령어 이름만 들어 있지 않습니다. 공주행, 압출, 리트랙션, 레이어 높이, 압력 보정 같은 개념도 담겨 있습니다. 이 개념들은 일련의 명령이 무엇을 이루려 하는지를 설명합니다.

각 정의는 용어를 G-code 파일에서 실제로 볼 수 있는 줄과 연결하고, 이 브라우저 뷰어가 무엇을 보여주고 무엇을 보여주지 못하는지 함께 밝힙니다.

개념 ≠ 명령어

공주행, 레이어 높이, 리트랙션은 동작과 상태 사이의 관계를 가리키며, 반드시 하나의 고정된 명령어와 대응하지는 않습니다. 앞선 모드, 현재 좌표, E 값의 변화, 슬라이서 주석, 대상 펌웨어를 함께 보고 판단해야 합니다.

의미의 세 층위

이동

좌표, 평면, 이송 속도는 툴이 어디로 어떻게 움직이는지를 나타냅니다.

재료

압출과 리트랙션 상태는 그 이동이 재료를 쌓는지, 프라이밍인지, 뽑아내는지를 결정합니다.

기계 상태

모달 명령과 펌웨어 설정은 이후 숫자 값의 해석 방식을 바꿉니다.

여섯 가지 기본 개념의 연결

개념이 흔적을 남기는 곳

근거의 출처	일반적인 형태	무엇을 알 수 있나
직접 명령	`G90, M83, M104`	위치 지정, 압출, 온도 등 목표나 상태를 명시적으로 바꿉니다.
값의 흐름	`X / Y / Z / E / F`	인접한 줄 사이의 차이로 방향, 적층, 리트랙션, 레이어 전환을 판별할 수 있습니다.
슬라이서 주석	`;LAYER, ;TYPE, ;FEATURE`	레이어 번호, 벽, 인필 등 슬라이서의 의도를 전달합니다. 정확한 표기는 슬라이서마다 다르며 표준이 아닙니다.
기계 외부 상태	`설정, 매크로, 센서, 기구`	최종 실행 결과를 좌우하지만, 보통 일반적인 G-code 파일만으로는 완전히 복원할 수 없습니다.

공주행과 압출은 맥락에 따라 달라집니다

공주행

G1 X80 Y40 F9000

압출량이 늘지 않은 채 헤드만 움직입니다.

압출 이동

M83
G1 X120 Y40 E1.6 F1800

상대 압출이 켜져 있으므로 E1.6은 이동하는 동안 필라멘트를 쌓습니다.

G90             ; X/Y/Z 절대 좌표
M83             ; E 상대 좌표
G1 Z0.20 F600   ; 출력 높이로 이동
G1 X60 E1.20    ; 이동하며 적층
G1 E-0.80       ; 리트랙션
G0 X90 Y40      ; 다음 구역으로 공주행
G1 E0.80        ; 프라이밍

이 예제에는 위치 지정 모드, 레이어 높이 단서, 압출, 리트랙션, 공주행, 프라이밍이 모두 들어 있습니다. 앞선 G90/M83 상태와 현재 위치를 모르면 어떤 줄도 정확히 해석할 수 없습니다.

혼동하기 쉬운 개념

혼동 주의	핵심 차이	파일에서 구분하는 법
공주행 / 리트랙션	공주행은 위치를 옮기는 것이고, 리트랙션은 흘러내림을 줄이려고 필라멘트를 잠시 뒤로 빼는 것입니다. 함께 나타나는 일이 많지만 서로 다른 동작입니다.	먼저 X/Y/Z 이동을 확인한 뒤, M82/M83 기준으로 E가 음수인지 양수인지 그대로인지 해석합니다.
레이어 높이 / Z 이동	레이어 높이는 쌓인 층 사이의 두께입니다. Z-홉도 Z를 움직이지만 새 레이어를 만들지는 않습니다.	재료를 쌓은 경로들의 Z 값을 비교하고 레이어 주석을 보조 근거로 쓰십시오. 모든 Z 변화를 레이어로 세면 안 됩니다.
이송 속도 / 실제 속도	F는 지시된 속도일 뿐입니다. 짧은 경로는 가속, 코너 제한, 기계 성능 때문에 그 속도에 도달하지 못할 수 있습니다.	G-code는 요청된 F를 보여줍니다. 실제 속도는 펌웨어의 경로 계획과 기계 설정에도 달려 있습니다.
E 값 / 실제 토출량	E는 보통 투입되는 필라멘트의 좌표나 길이를 뜻하며, 그만큼의 플라스틱이 노즐에서 나왔음을 증명하지는 않습니다.	파일은 지시된 양만 알려줍니다. 실제 토출량은 필라멘트 지름, 유량 배율, 온도, 미끄러짐, 막힘에도 좌우됩니다.
프레셔 어드밴스 / 리트랙션	프레셔 어드밴스는 압출 속도 변화에 맞춰 실시간으로 보정하고, 리트랙션은 보통 공주행 전후로 필라멘트를 빼고 되돌립니다. 둘은 함께 쓰일 수 있습니다.	리트랙션은 E 변화나 G10/G11로 드러나는 경우가 많고, 프레셔 어드밴스는 펌웨어 설정이나 M900, M572, Klipper 확장에서 올 수 있습니다.

용어는 시스템마다 다를 수 있습니다

3D 프린터 펌웨어, 슬라이서, CNC 컨트롤러는 같은 단어를 서로 다른 동작에 쓰기도 하고, 같은 목적에 다른 단어를 쓰기도 합니다. 예를 들어 “프레셔 어드밴스”는 펌웨어 계열마다 대응하는 명령과 값 체계가 다릅니다.

그래서 용어 페이지는 한 펌웨어의 어휘를 표준처럼 다루지 않고, 쉬운 말로 설명한 개념을 실제 명령 맥락과 연결합니다.

해결하려는 문제에 따라 배우기

첫 파일

절대/상대 위치 지정부터 시작해 G0/G1과 압출 모드로 넘어가십시오. 툴이 어디로 가는지, 그 이동이 재료를 쌓는지를 알 수 있습니다.

실 늘어짐 진단

공주행, 리트랙션, 경로 선택, 온도, 압력 보정을 함께 살펴보십시오. 리트랙션만 늘려서는 젖은 필라멘트나 과열, 모든 경로 문제를 해결할 수 없습니다.

표면 품질

같은 경로에서 레이어 높이, 이송 속도, 압출, 프레셔 어드밴스를 비교하십시오. F가 있다고 기계가 그 속도에 도달했다는 뜻은 아닙니다.

뷰어가 보여줄 수 있는 것

파일에서 확인할 수 있는 것

뷰어는 지원되는 이동, 압출 변화, 좌표 모드, 슬라이서가 남긴 일부 정보를 보여줄 수 있습니다. 프린터 설정을 확인해 주거나 실제 기계가 어떻게 움직일지 정확히 예측하지는 못합니다.

용어 페이지 활용법

간결한 정의를 먼저 읽고, 이어서 코드 예제를 확인하십시오.
모달 상태가 결과를 바꿀 때는 관련 명령어의 맥락을 따라가십시오.
뷰어 안내를 참고해 파일이 보여주는 것과 프린터만 결정할 수 있는 것을 구분하십시오.

이 안내에 사용한 공식 출처

2026년 8월 8일에 펌웨어·컨트롤러·슬라이서의 1차 문서를 바탕으로 작성했습니다. 정의는 공통된 의미를 따르고, 시스템별 차이는 분명히 밝힙니다.