TypeScript如何指定导入@types/ol中的GeometryLayout枚举类型？

我正在开发一个基于Vite+TypeScript的项目，使用OpenLayers库（此问题不针对OpenLayers，仅作背景说明）。package.json中依赖ol，开发依赖为@types/ol。代码中使用如下导入语句：

import GeometryLayout from 'ol/geom/GeometryLayout';

不清楚TypeScript会读取哪个定义文件，目前node_modules里有三个相关文件：

$ find node_modules/ | grep GeometryLayout | grep -v map$ | grep -v src
node_modules/ol/geom/GeometryLayout.d.ts
node_modules/ol/geom/GeometryLayout.js
node_modules/@types/ol/geom/GeometryLayout.d.ts

这三个文件定义各不相同：

• node_modules/ol/geom/GeometryLayout.d.ts：

declare namespace _default {
    const XY: string;
    const XYZ: string;
    const XYM: string;
    const XYZM: string;
}
export default _default;

• node_modules/ol/geom/GeometryLayout.js：

/**
 * @module ol/geom/GeometryLayout
 */
/**
 * The coordinate layout for geometries, indicating whether a 3rd or 4th z ('Z')
 * or measure ('M') coordinate is available. Supported values are `'XY'`,
 * `'XYZ'`, `'XYM'`, `'XYZM'`.
 * @enum {string}
 */
export default {
    XY: 'XY',
    XYZ: 'XYZ',
    XYM: 'XYM',
    XYZM: 'XYZM',
};

• node_modules/@types/ol/geom/GeometryLayout.d.ts：

/**
 * The coordinate layout for geometries, indicating whether a 3rd or 4th z ('Z')
 * or measure ('M') coordinate is available. Supported values are 'XY',
 * 'XYZ', 'XYM', 'XYZM'.
 */
declare enum GeometryLayout {
    XY = 'XY',
    XYZ = 'XYZ',
    XYM = 'XYM',
    XYZM = 'XYZM',
}

export default GeometryLayout;

根据报错Cannot use namespace 'GeometryLayout' as a type，推测当前用的是node_modules/ol/geom/GeometryLayout.d.ts，想知道如何专门导入@types/ol里定义的enum类型。

附当前配置：

tsconfig.json #

{
  "compilerOptions": {
    "target": "ES2020",
    "useDefineForClassFields": true,
    "lib": ["ES2020", "DOM", "DOM.Iterable"],
    "module": "ESNext",
   
    /* Bundler mode */
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react-jsx",

    /* Linting */
    "strict": true,
    "strictNullChecks": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noFallthroughCasesInSwitch": true
  },
  "include": ["src"],
  "references": [{ "path": "./tsconfig.node.json" }]
}

vite.config.ts #

import { defineConfig } from 'vite'
import { fileURLToPath, URL } from "url";
import react from '@vitejs/plugin-react'
import checker from 'vite-plugin-checker';

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    react(),
    checker({
      typescript: true
    })
  ],
  resolve: {
    alias: [
      { find: '@', replacement: fileURLToPath(new URL('./src', import.meta.url)) },
      { find: '@types', replacement: fileURLToPath(new URL('./node_modules', import.meta.url)) },
    ]
  }
})

方法一：配置TypeScript优先加载@types定义 #

修改tsconfig.json的compilerOptions，添加typeRoots和types配置，强制TypeScript只从@types目录读取类型定义：

{
  "compilerOptions": {
    // 保留原有配置
    "typeRoots": ["./node_modules/@types"],
    "types": ["ol"]
  }
}

• typeRoots限定类型定义的搜索范围为@types目录，会忽略ol包自带的.d.ts文件
• types明确指定加载@types/ol的类型定义

方法二：直接导入@types下的目标文件（临时方案） #

如果仅需临时使用该enum类型，可以直接写完整路径导入：

import GeometryLayout from '@types/ol/geom/GeometryLayout';

注意：这种方式会打破正常的包导入逻辑，后续若ol包更新自带正确类型，需改回标准导入，不建议长期使用。

方法三：删除ol包自带的冲突类型文件（暴力方案） #

手动删除node_modules/ol/geom/GeometryLayout.d.ts，或整个ol包下的.d.ts文件。但每次执行npm install后文件会恢复，仅适合临时测试。

方法四：移除冗余的@types/ol依赖 #

很多现代库（包括OpenLayers）已自带完整类型定义，无需额外安装@types/ol。尝试卸载该依赖：

npm uninstall @types/ol

卸载后若类型提示正常且报错消失，说明ol自带类型已满足需求，之前的冲突是因为重复安装了类型定义。

内容的提问来源于stack exchange，提问作者Marcus Junius Brutus