react項目添加typescript類型定義文件 .d.ts

最近用react + antd mobile + typescript開發項目，其中使用了rc-form這個包，可惜沒有typescript版本，導致找不到類型定義。

一起來重溫一下這個經典的錯誤。

D:/Code/test/src/pages/me/register/RegisterTest.tsx
TypeScript error in D:/Code/test/src/pages/me/register/RegisterTest.tsx(5,28):
File 'D:/Code/test/src/rc-form.d.ts' is not a module.  TS2306

    3 | import BrowserHistory from '../../../router/BrowserHistory';
    4 | import { AppUrls } from '../../../http/AppUrls';
  > 5 | import { createForm } from "rc-form";
      |                            ^
    6 | import MyToast from '../../../componets/MyToast';
    7 | 
    8 | export function RegisterTest(props: any) {

解決辦法：

在網上查了很久，那些修改typeRoots的方法根本不好使，太坑人了。下面的方法絕對好用！

1. 修改項目根目錄下的tsconfig.json文件，添加baseUrl選項，由於項目是用create-react-app創建的，這個值只能是src或者node_modules，推薦用src。

2. 編寫類型定義文件rc-form.d.ts,內容如下：

declare module 'rc-form' {
    export const createForm: Function;
}

3. 將rc-form.d.ts放入項目的src目錄下。

4. 在需要使用rc-form模塊的文件里直接導入即可。

import { createForm } from "rc-form";

===

最新方法：

tsconfig這樣配置，注意typeRoots要放到compilerOptions結點下面。

{
  "compilerOptions": {
    "target": "es6",
    "lib": [
      "dom",
      "dom.iterable",
      "esnext",
      "es2015"
    ],
    "allowJs": true,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "noEmit": true,
    "jsx": "react",
    "baseUrl": "src",
    "typeRoots": [ "src/custom_types", "node_modules/@types" ]
  },
  "include": [
    "src"
  ]
}

2. src目錄下新建一個文件夾custom_types,放入類型定義文件，如下。

===