Question 1

종료 시 발생하는 tsgo LSP 서버 패닉 'assignment to entry in nil map'을 수정하는 방법

Accepted Answer

이는 네이티브 TypeScript 컴파일러(tsgo / typescript-go, typescript@7.0.2)에서 발생하는 종료 경합(shutdown race)입니다. LSP 클라이언트가 동적 파일 감시 등록을 지원한다고 알리지 않으면, 서버의 내부 watcher(`internal/lsp/lspwatcher`)가 watch subscription을 설치하는 동안 mutex를 해제합니다. 이와 동시에 `Close`가 실행되어 `w.watches = nil`로 설정되면, 설치 후 이어지는 append가 `assignment to entry in nil map` 패닉을 일으키고, 그 결과 `tsgo --lsp --stdio`가 종료 코드 2로 종료됩니다. 수정 방법: subscription을 게시하기 전에 락 안에서 `closed` 플래그를 다시 확인하고 패닉 대신 `lspwatcher: closed` 오류를 반환하는 PR microsoft/typescript-go#4845가 포함된 `@typescript/native-preview`(tsgo) 빌드로 업그레이드하세요. 영향을 받는 빌드에 고정되어 있는 경우의 우회 방법: LSP 클라이언트에서 동적 파일 감시 등록을 활성화(`workspace.didChangeWatchedFiles.dynamicRegistration: true`)하여 서버가 내부 watcher 경로를 건너뛰도록 하세요.

Question 2

How to fix a non-exported recursive type alias being inlined and becoming `any` in TypeScript declaration files?

Accepted Answer

This happens with `declaration: true` when an exported value uses a non-exported recursive type. The declaration emitter cannot reference the private type name, so it inlines the recursion until it reaches its depth limit and substitutes `any`. Fix it by exporting the recursive type alias from the module that declares it: ```ts // utils.ts export type Recursive = T extends Array ? Recursive : T; export const f = (): Recursive => null!; ``` Then rebuild with `npx tsc -p tsconfig.json`. The generated `.d.ts` can now reference `Recursive` instead of unrolling it. If the type must remain private, remove it from the exported API or give the exported declaration an explicit public return type. A compiler fix was also made in typescript-go PR #4507 to report a declaration error instead of silently producing `any`.

Question 3

지역 변수가 export를 가릴 때 TypeScript CommonJS 출력이 함수 루프 내부에 exports.x를 추가하는 문제를 어떻게 해결하나요?

Accepted Answer

이것은 tsgo CommonJS transformer의 회귀입니다: 이름이 export된 이름과 일치하는 블록 스코프 루프 변수가 잘못하여 exports.name = name 할당을 받습니다. 이는 tsgo 7.0/dev 빌드에서 재현되며, TypeScript 6.0.3은 올바른 코드를 생성합니다.

우회 방법:

1. 루프 로컬 변수의 이름을 바꿔서 export를 shadow하지 않도록

Question 4

node_modules의 .d.ts 파일에서 'declare global' 타입을 변경한 후 tsc --incremental이 오류를 놓치는 이유는 무엇인가요?

Accepted Answer

이것은 TypeScript 7.0.x의 알려진 회귀 문제입니다(5.6.1-rc에서도 발생하며, 6.0.3에서는 정상 작동): 패키지의 선언 파일(`types`를 통해 로드되며 import되지 않음)에 있는 `declare global` 블록이 변경되면 증분 빌드가 오래된 진단을 계속 유지하므로, 증분 실행에서는 오류가 보고되지 않지만 클린 `tsc` 실행에서는 오류(예: TS2345)가 보고됩니다. 해결 방법: TypeScript 7.1 이상으로 업그레이드하세요(7.1 nightly에서 수정이 확인됨). 영향받는 버전에서의 우회 방법: 매 실행 전에 `.tsbuildinfo` 파일을 삭제하거나(예: `rm tsconfig.tsbuildinfo`) `--incremental` 없이 `tsc --noEmit`을 실행하여 전체 재검사를 강제하세요.

Question 5

TypeScript는 왜 import defer "./a.js"를 허용하고 이를 일반적인 eager import로 출력하나요?

Accepted Answer

단독 import defer "./a.js"는 유효하지 않습니다: 지연된 import 제안은 namespace binding을 요구합니다. TypeScript는 이를 잘못 허용하고 defer를 제거하여 import "./a.js"를 생성하며, 이는 모듈을 즉시 평가합니다.

지연 평가를 위해서는 namespace import를 사용하세요:

import defer * as ns from "./a.js";

의도적으로 side-effect-only import를 원한다면, 대신 일반 eager import를 사용하세요:

import "./a.js";

영향을 받는 버전에는 TypeScript 5.9.3 및 7.1.0-dev.20261004.1이 포함됩니다.

TypeScript

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트