언어의 환상: 지시어(Directives)의 진실

서문 및 소개 — 이 글이 존재하는 이유

이 글은 반박이 아닙니다. 이는 Tanner Linsley의 훌륭한 글 "Directives and the Platform Boundary"에서 영감을 받은 반성입니다. 저는 이 글을 진심으로 즐겼고, 특히 소유권, 출처, 명시적 API의 가치에 대한 많은 점에 동의합니다. 제가 추가하고 싶었던 것은 디렉티브 기반 도구를 구축하고 JavaScript에 'use client'나 'use server'가 생기기 훨씬 전의 프로그래밍 역사에서 매우 유사한 장을 경험한 사람으로서의 약간 다른 관점입니다.

React Server Components와 Next.js와 같은 프레임워크의 진화를 따라오지 않았다면: 현대 React 앱은 이제 와 와 같은 파일 수준의 디렉티브를 사용하여 코드가 실행되는 위치를 제어합니다. 이들은 파일 상단의 단순한 문자열 리터럴처럼 보이지만, 컴포넌트가 서버나 클라이언트에서 실행되는지를 결정하여 번들링, 렌더링 및 데이터 흐름을 형성합니다. 여기서 혼란이 시작됩니다.

개인적인 회상

왜 디렉티브가 언어 기능처럼 느껴질까요?

'use client';

export function Button() {
  return <button>Click</button>;
}

“JavaScript의 일부입니다.”

“파일 상단의 디렉티브는 권위적으로 보입니다. 이는 언어 수준의 진실처럼 보이며, 프레임워크 힌트가 아닙니다.”

숨겨진 메커니즘이 상황을 악화시킵니다

import { client } from 'somewhere';

빌드 도구를 추가하면 환상이 굳어집니다

“번들러가 작동하려면 플랫폼의 일부가 아니라 언어의 일부가 아닌가요?”

C/C++ 매크로와 전처리기: 과거를 돌아보다

C 전처리기는 언어가 아니었지만 언어처럼 느껴졌습니다

#define PI 3.14

'use server';

프래그마: 원래의 "프레임워크 디렉티브"

#pragma once

인클루드 가드: 최초의 "보이지 않는 빌드 타임 동작"

#ifndef MY_HEADER_H
#define MY_HEADER_H

// header contents

#endif

C/C++는 개발자들에게 "파일에 작성한 코드"와 "언어 자체"가 동일하지 않다는 것을 배우도록 강요했습니다.

다단계 컴파일: 익숙한 파이프라인

Preprocessor → Compiler → Linker → Executable

Directive Scanner / Loader → AST Transforms → Bundler → Output Chunks

전처리기 시대의 렌즈를 통해 본 현대 디렉티브

디렉티브는 실행되지 않습니다 — 도구에 지시합니다

그들은 스스로 아무것도 하지 않습니다 — 그들은 단지 다른 것이 어떻게 동작하는지를 변경합니다.

파일 읽기 → 디렉티브 확인 → 환경 / 경계 결정 →
변환 실행 → 클라이언트/서버 번들 생성 → 출력

파일 읽기 → 전처리기가 매크로 확장 + 프래그마 처리 →
컴파일 → 링크 → 출력

언어 기능의 환상이 지속되는 이유

하지만 현대 디렉티브는 C 프래그마보다 더 나아갑니다

무언가가 런타임 실행과 코드 배치에 영향을 미친다면, 우리는 그것을 "파일 상단의 단순한 문자열"로 취급해서는 안 됩니다.

빌드 도구는 디렉티브의 실제 해석자입니다

'use streaming-server';

📦 인라인 서버 함수가 디렉티브의 필요성을 드러낼 때

export default function Dashboard() {
  const rate = 0.27;

  async function save(value) {
    'use server';
    return value * rate; // ← 컴포넌트 스코프에서 "rate"를 캡처합니다
  }

  return <button onClick={() => save(10)}>Save</button>;
}

교육적 격차 — 그리고 역사로부터 배울 수 있는 것

문제는 더 이상 기술적이지 않습니다 — 교육적입니다.

레이어링을 가르쳐야 합니다 — 단순히 기능만이 아닙니다

C/C++ 커뮤니티가 결국 배운 것

디렉티브는 나쁘지 않습니다 — 이해하면 강력합니다

내일부터 가르칠 수 있는 간단한 정신 모델

“디렉티브는 JavaScript가 아닌 빌드 도구를 위한 메모입니다.”

`#pragma once`가 C++ 구문이 아니었다면, “use client”도 JavaScript 구문이 아닙니다.”

명확성을 향한 실질적인 단계: 디렉티브를 위한 TypeScript 플러그인

TypeScript 플러그인이 디렉티브를 "강제"할 수 있다는 일반적인 가정이 있습니다 — 플러그인이 이를 알고 있다면, 시스템이 기본적으로 안전해진다는 것입니다. 하지만 TS 플러그인은 언어 서비스에 존재합니다. 이는 인식, 경고, 지침을 제공할 수 있지만 — 여전히 코드가 실제로 변환되는 곳에서 실행되지 않습니다. 이는 컴파일이나 번들링에 참여하지 않습니다.

'use server' satisfies Directive;

마무리 반성