使用create-react-app 搭建react + ts + antd框架

一、创建项目

 使用npx create-react-app (项目名) --template typescript  创建项目

①如果App.tsx文件有如下报错: （没有报错的请忽略）

需要将tsconfig.json文件里的 "jsx": "react-jsx" 配置改为 "jsx": "react" 即可。

② 此时运行yarn start会报错

此时需要将react-scripts版本4.0.0降级为3.4.4  （参考: https://stackoverflow.com/questions/64593336/typeerror-cannot-assign-to-read-only-property-paths-of-object-for-compileropt ）

③ 如遇到报错 :  TypeScript 引入第三方包，报无法找到模块错误 (参考: https://www.cnblogs.com/xym4869/p/13323483.html )

二、安装ant-design 并配置自定义主题、按需加载（参考antd官网）、绝对路径的引用

yarn add antd @craco/craco craco-less

yarn add @babel/plugin-proposal-decorators babel-plugin-import --dev

①修改  package.json 里的  scripts 属性:

"scripts": {
    "start": "set PORT=3000 && craco start",
    "build": "set GENERATE_SOURCEMAP=false && craco build",
    "test": "craco test"
  },

② 在项目根目录创建一个  craco.config.js 用于修改默认配置 （参考: https://blog.csdn.net/qq_39223195/article/details/106287522 ）

const CracoLessPlugin = require('craco-less');
const path = require('path')

const pathResolve = pathUrl => path.join(__dirname, pathUrl)

module.exports = {
    webpack: {
        alias: {
            '@@': pathResolve('.'),
            '@': pathResolve('src'),
            '@common': pathResolve('src/common'),
            '@config': pathResolve('src/config'),
            '@components': pathResolve('src/components'),
        }
    },
    babel: {
        plugins: [
            ['import', { libraryName: 'antd', style: true }],
            ['@babel/plugin-proposal-decorators', { legacy: true }]
        ]
    },
    plugins: [
        {
            plugin: CracoLessPlugin,
            options: {
                lessLoaderOptions: {
                    lessOptions: {
                        modifyVars: { '@primary-color': 'red' },
                        javascriptEnabled: true,
                    },
                },
            },
        },
    ],
};

③在根目录创建 paths.json 文件

{
    "compilerOptions": {
        "baseUrl": "./",
        "paths": {
          "@@/*": ["./*"],
          "@/*": ["src/*"],
          "@common/*": ["src/common/*"],
          "@config/*": ["src/config/*"],
          "@components/*": ["src/components/*"]
        }
    }
  }

④修改tsconfig.json配置，添加上以下内容。将paths.json文件引入。直接在tsconfig.json文件里写会报错。 这样配置完之后引入文件的时候可以@/xxx/xxx并且会有提示。

"extends": "./paths.json",

⑤ 将App.css和index.css改为App.less和index.less

⑥ demo

三、代码规范（eslint）的配置 (参考: https://www.npmjs.com/package/eslint )

./node_modules/.bin/eslint --init

如果是windows系统需要将‘/’换成 ‘ \ ’，  然后按照自己的需求来选择配置即可。