相对导入无法解析为环境模块

Question

根据打字稿文档（https://www.typescriptlang.org/docs/handbook/module-resolution.html）：

相对导入是相对于导入文件解析的，并且 无法解析为环境模块声明。

还有：

例如，像 import { b } from "./moduleB" in /root/src/moduleA.ts 将导致尝试以下操作 定位“./moduleB”的位置：

/root/src/moduleB.ts
/root/src/moduleB.tsx
/root/src/moduleB.d.ts
/root/src/moduleB/package.json (if it specifies a "typings" property)
/root/src/moduleB/index.ts
/root/src/moduleB/index.tsx
/root/src/moduleB/index.d.ts"

/root/src/moduleB.d.ts 行在我看来是用于解决相对导入“./moduleB”的环境模块声明 -> 正是文档否认它所做的.

是我遗漏了什么还是文档有误？

Answer 1

简答

/root/src/moduleB.d.ts 这行在我看来是环境模块声明...我在这里遗漏了什么还是文档有误？

你在这里遗漏了一些东西。 moduleB.d.ts 不是环境模块声明。这是一个包含moduleB 环境模块声明的文件示例。

// someFile.d.ts 

declare module "moduleB" {
    export class b { }
}

declare 关键字指定环境声明。

一些细节

关于环境这个词，the documentation says：

我们将未定义实现的声明称为“环境”。通常，这些是在 .d.ts 文件中定义的。

环境声明包括但不限于环境模块声明。包含环境声明的 .d.ts 文件不是环境模块声明，也不一定包含环境模块声明。

例如，以下 greeter.d.ts 文件包含环境类声明，但它不是环境模块声明。

// greeter.d.ts

declare class Greeter {
    constructor(greeting: string);
    greeting: string;
}

以下foobar.d.ts 文件包含两个环境模块声明“foo”和“bar”，但文件本身不是环境模块声明。

// foobar.d.ts

declare module "foo" {       
    export function doFoo(foo: string): string;
}

declare module "bar" {
    export function doBar(bar: string): string;
}

您最初引用的文档指出，"./foo" 的相对导入无法解析为该模块的上述环境声明。

更多详情

见：https://www.typescriptlang.org/docs/handbook/modules.html

另见：https://github.com/Microsoft/TypeScript-Handbook/issues/180

另请参阅：https://www.typescriptlang.org/docs/handbook/declaration-files/by-example.html