microsoft / microsoft/TypeScript

Behavior difference: Type emit inconsistency with dangling block comment in file

未关闭
#63,837 0 条评论 1 个 reaction 已指派 2 人 在 GitHub 查看

@jakebailey 已经在做这个了。

开始于 2026年6月16日。

Possible Improvement
主要语言
Go
星标
111k
派生
14.3k
平均合并
2 天 4 小时
30 天内合并 PR
132

描述

Summary as below. I call this situation dangling block comment, since there are more than just newlines in between the block comments and the attached variables in the code.

Note that a fix for top, .ts will be a breaking change from TS 6.

tsc tsgo
nonTop, .js ✅ Dangling comment erased ✅ Dangling comment erased
nonTop, .ts ✅ Dangling comment erased ✅ Dangling comment erased
top, .js ✅ Dangling comment erased ❌ Dangling comment attached to incorrect variable
top, .ts ❌ Dangling comment attached to incorrect variable ❌ Dangling comment attached to incorrect variable

Steps to reproduce

  1. Start a plain new project
    • "@typescript/native-preview": "7.0.0-dev.20260612.1",
    • "typescript": "6.0.3"
  2. Run npx tsgo --init to get the default tsconfig. Turn on these flags as well.
    • "allowJs": true,
    • "checkJs": true,
    • "stableTypeOrdering": true,
    • "removeComments": false,
  3. Add the below files. Run npx tsc & npx tsgo to see the difference.
/** ========> src/nonTopComment-js.js <======== */
export const e = 3;

/** Comment on nothing */

/** Comment on noop */
(function noop() {})();

export const pi = 3;

/** ========> src/nonTopComment-ts.ts <======== */
export const e = 3;

/** Comment on nothing */

/** Comment on noop */
(function noop() {})();

export const pi = 3;

/** ========> src/topComment-js.js <======== */
/** Comment on nothing */

/** Comment on noop */
(function noop() {})();

export const pi = 3;

/** ========> src/topComment-ts.ts <======== */
/** Comment on nothing */

/** Comment on noop */
(function noop() {})();

export const pi = 3;

Behavior with typescript@6.0

/** ========> dist/nonTopComment-js.d.ts <======== */
export const e: 3;
export const pi: 3;
//# sourceMappingURL=nonTopComment-js.d.ts.map

/** ========> dist/nonTopComment-ts.d.ts <======== */
export declare const e = 3;
export declare const pi = 3;
//# sourceMappingURL=nonTopComment-ts.d.ts.map

/** ========> dist/topComment-js.d.ts <======== */
export const pi: 3;
//# sourceMappingURL=topComment-js.d.ts.map

/** ========> dist/topComment-ts.d.ts <======== */
/** Comment on nothing */
export declare const pi = 3;
//# sourceMappingURL=topComment-ts.d.ts.map

Behavior with tsgo

/** ========> dist/nonTopComment-js.d.ts <======== */
export declare const e = 3;
export declare const pi = 3;
//# sourceMappingURL=nonTopComment-js.d.ts.map

/** ========> dist/nonTopComment-ts.d.ts <======== */
export declare const e = 3;
export declare const pi = 3;
//# sourceMappingURL=nonTopComment-ts.d.ts.map

/** ========> dist/topComment-js.d.ts <======== */
/** Comment on nothing */
export declare const pi = 3;
//# sourceMappingURL=topComment-js.d.ts.map

/** ========> dist/topComment-ts.d.ts <======== */
/** Comment on nothing */
export declare const pi = 3;
//# sourceMappingURL=topComment-ts.d.ts.map

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。