TypeScript无法识别全局.d.ts文件中声明的namespace问题求助

你遇到的Cannot find namespace 'Content'错误，核心原因很明确：你的content.d.ts文件因为包含了顶级的import语句，被TypeScript判定为一个模块，而非全局声明文件。在TypeScript的规则里，只要文件存在顶级的import或export，它就会脱离全局作用域，里面的declare namespace也不再是全局可访问的。

下面是针对性的解决办法，你可以根据自己的需求选择：

办法1：将导入语句移入namespace，保持文件为全局声明 #

如果希望Content继续作为全局命名空间使用，你需要把import语句移到declare namespace内部，使用类型导入的方式（避免让文件成为模块）：

declare namespace Content {
  // 用import type导入所需类型，这样不会让文件变成模块
  import type * as something from 'something';
  // 如果只需要某个具体类型，可以更精准：
  // import type { Object as InternalObject } from 'something';

  type Object = something.Object; // 对应你原来的internal.Object，调整为实际导入的类型路径
}

修改后，这个文件不再是模块，Content命名空间会自动成为全局可用的，你的TSX文件无需任何导入就能直接使用Content.Object。

办法2：将namespace导出，在TSX中手动导入 #

如果你的content.d.ts确实需要保留顶级import（比如要导入非类型的内容），可以把Content命名空间导出，然后在使用它的TSX文件中手动导入：

1. 修改content.d.ts：

import * as something from 'something';
// 给namespace加上export，使其成为模块的导出成员
export declare namespace Content {
  type Object = something.Object;
}

2. 在TSX文件中导入并使用：

import * as React from 'react';
// 根据你的文件相对路径调整导入路径
import { Content } from './typings/content';

interface ExampleComponentProps {
  example: Content.Object;
}

export const ExampleComponent: React.FunctionComponent<ExampleComponentProps> = ({ example }) => {
  return <div>{example}</div>;
};

额外检查项 #

虽然你的tsconfig.json里的include配置已经包含了./src/typings/*.d.ts，但还是可以快速确认：

• 确保content.d.ts的路径和include规则匹配，没有拼写错误
• 确认baseUrl配置正确（你的是./src，所以路径是没问题的）

内容的提问来源于stack exchange，提问作者Meatgear