Question 1

シャットダウン時に発生する tsgo LSP サーバーの panic 'assignment to entry in nil map' を修正する方法

Accepted Answer

これは、ネイティブ TypeScript コンパイラ (tsgo / typescript-go, typescript@7.0.2) におけるシャットダウン時の競合状態 (race) です。LSP クライアントが動的ファイルウォッチ登録をアドバタイズしない場合、サーバーの内部ウォッチャー (`internal/lsp/lspwatcher`) はウォッチサブスクリプションのインストール中にミューテックスを解放します。その間に並行して実行された `Close` が `w.watches = nil` を設定し、インストール後の append が `assignment to entry in nil map` によってパニックを引き起こし、`tsgo --lsp --stdio` がステータス 2 で終了します。修正方法: PR microsoft/typescript-go#4845 を含む `@typescript/native-preview` (tsgo) のビルドにアップグレードしてください。この PR では、サブスクリプションを公開する前にロック下で `closed` フラグを再確認し、パニックする代わりに `lspwatcher: closed` エラーを返します。影響を受けるビルドに固定されている場合の回避策: LSP クライアントで動的ファイルウォッチ登録を有効にし (`workspace.didChangeWatchedFiles.dynamicRegistration: true`)、サーバーが内部ウォッチャーのパスをスキップするようにしてください。

Question 2

エクスポートされていない再帰型エイリアスがインライン化されて TypeScript 宣言ファイルで any になってしまうのを修正する方法は？

Accepted Answer

これは、エクスポートされた値がエクスポートされていない再帰型を使用しているときに declaration: true で発生します。宣言エミッターはプライベート型名を参照できないため、再帰を深さ制限に達するまでインライン展開し、any で置き換えます。

修正するには、それを宣言しているモジュールから再帰型エイリアスをエクスポートします:

//

Question 3

ローカル変数が export をシャドーイングするとき、TypeScript の CommonJS 出力が関数内のループ内で exports.x を追加するのを修正するにはどうすればよいですか？

Accepted Answer

これは tsgo の CommonJS トランスフォーマーにおけるリグレッションです。名前がエクスポート名と一致するブロックスコープのループ変数が、誤って exports.name = name の代入を受け取ります。これは tsgo 7.0/dev ビルドで再現し、一方、TypeScript 6.0.3 は正しいコードを出力します。

回避策:

1. ループローカル変数の名前を変更して、エクスポートをシャドーイングしないようにします:
export function f(xs: number[]) {
  for (const x of xs) {
    const localMount = x;
    console.log(localMount);
  }
}
function mount() {}
export { mount };

2. 影響を受ける tsgo ビルドの代わりに、安定した JavaScript ベースのコンパイラを使用します:
npm install -D typescript@6.0.3
npx tsc

3. tsgo をローカルでビルドする場合は、internal/transformers/moduletransforms/commonjsmodule.go にパッチを当てます。非トップレベルのループでは、topLevelNestedVisitor の代わりに通常のビジターでループ本体を訪問します:
- tx.EmitContext().VisitIterationBody(node.Statement, tx.topLevelNestedVisitor)
+ tx.EmitContext().VisitIterationBody(node.Statement, tx.Visitor())
visitForInOrOfStatement にも同等の変更を適用します。トップレベルのループは引き続きトップレベルネストビジターを使用する必要があります。修正は関連するプルリクエストで追跡されています。

Question 4

node_modules の .d.ts ファイル内の 'declare global' 型を変更した後に、tsc --incremental がエラーを見逃すのはなぜですか？

Accepted Answer

これは TypeScript 7.0.x における既知のリグレッションです（5.6.1-rc でも発生。6.0.3 では正常に動作していました）。パッケージの宣言ファイル（import ではなく `types` 経由で読み込まれるもの）内の `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" は無効です：deferred import proposal は namespace binding を要求します。TypeScript はこれを誤って受け入れ、defer を落として import "./a.js" を生成するため、モジュールは eager に評価されます。

Deferred 評価には namespace import を使用してください：

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

副作用のみのインポートを意図している場合は、代わりに通常の eager import を使用してください：

import "./a.js";

影響を受けるバージョンには TypeScript 5.9.3 および 7.1.0-dev.20261004.1 が含まれます。

TypeScript

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト