一、创建
安装 npm install -g create-react-app
create-react-app my-app
cd my-app
npm start
环境变量问题 npm init react-app my-app;
其他方式 yarn create react-app my-app
二、运行
启动
启动开发
npm start
yarn start
启动测试
npm test
#or
yarn test
构建生产版本
npm run build
#or
yarn build
解压默认的webpack配置到配置文件中
npm run eject
三、配置
sass依赖
$ npm install node-sass --save
$ # or
$ yarn add node-sass
代理配置
配置简单代理,直接在package.json文件中添加proxy节点即可:
{
…
“proxy”: “http://localhost:4000”,
…
}
自定义配置
安装中间件
$ npm install http-proxy-middleware --save
$ # or
$ yarn add http-proxy-middleware
创建: src/setupProxy.js 添加如下内容:
const proxy = require('http-proxy-middleware');
module.exports = function(app) {
app.use(proxy('/api', { target: 'http://localhost:5000/' }));
};
http-proxy-middleware 1.x比0.x变化较大,正确写法如下
const {createProxyMiddleware} = require('http-proxy-middleware');
module.exports = function(app) { app.use(createProxyMiddleware('/api', { target: 'http://localhost:5000/' })); };
环境变量:在项目中区分开生产环境还是编译环境,从而执行不同的代码。
Windows (cmd.exe)
set “REACT_APP_NOT_SECRET_CODE=abcdef” && npm start
Windows (Powershell)
($env:REACT_APP_NOT_SECRET_CODE = “abcdef”) -and (npm start)
Linux, macOS (Bash)
REACT_APP_NOT_SECRET_CODE=abcdef npm start
添加自定义环境变量文件.env
项目根目录下创建.env文件,文件内部添加 key=value的配置可以直接应用于项目的编译中。
REACT_APP_NOT_SECRET_CODE=abcdef
Note: 如果创建自定义的环境变量必须以REACT_APP_开头.
在项目中可以直接用process.env.XXX访问我们的自定义的环境变量。比如:
js中使用
render() {
return (
<div>
<small>You are running this application in <b>{process.env.NODE_ENV}</b> mode.</small>
<form>
<input type="hidden" defaultValue={process.env.REACT_APP_NOT_SECRET_CODE} />
</form>
</div>
);
}
再比如:判断是否是生产环境
if (process.env.NODE_ENV !== 'production') {
analytics.disable();
}
HTML中使用
配合typescript
配合TypeScript
第一种方式:创建项目的时候直接配置好TypeScript.
npx create-react-app my-app --typescript
#or
yarn create react-app my-app --typescript
第二种方式:为现有的React项目添加TypeScript
npm install --save typescript @types/node @types/react @types/react-dom @types/jest
yarn add typescript @types/node @types/react @types/react-dom @types/jest
参考:https://www.jianshu.com/p/77bf3944b0f4
配置本地服务配置项
方法1.eject
打开 package.json ,可以看到eject。运行 npm run eject 可以让由create-react-app创建的项目的配置项暴露出来。
{
...
"scripts": {
...
"eject": "react-scripts eject"
},
...
}
此时目录中多出来配置文件夹
scripts文件夹start.js中修改配置
// Tools like Cloud9 rely on this.
const DEFAULT_PORT = parseInt(process.env.PORT, 10) || 3000;
const HOST = process.env.HOST || '0.0.0.0'
重启项目
方法2.react-app-rewired
安装 npm install react-app-rewired --save
修改package.json,原本的react-script 改为react-app-rewired
"scripts": {
"start": "react-app-rewired start",
"build": "react-app-rewired build",
"test": "react-app-rewired test",
"eject": "react-app-rewired eject"
},
在根目录下新建config-overrides.js,在config-overrides.js里更改配置项,项目启动的时候会先在config-overrides.js里读数据,对webpack里的默认文件进行整合,最后才会启动。
const { injectBabelPlugin } = require('react-app-rewired');
module.exports = function override(config, env) {
config = injectBabelPlugin([
'import', { libraryName: 'antd', libraryDirectory: 'es', style: 'css' }
], config)
config = injectBabelPlugin([
"@babel/plugin-proposal-decorators", { "legacy": true }
], config)
return config;
}
参考:https://www.cnblogs.com/superlizhao/p/11026930.html
运行npm run eject之后bug解决
方法一、
// package.json中增加配置项
{
"babel": {
"presets": [
[
"react-app",
{
"runtime": "automatic"
}
]
]
}
}
方法二、
// webpack.config.js
{
loader: require.resolve('babel-loader'),
options: {
customize: require.resolve(
'babel-preset-react-app/webpack-overrides'
),
// Add this back
presets: [
[
require.resolve('babel-preset-react-app'),
{
runtime: hasJsxRuntime ? 'automatic' : 'classic',
},
],
],
}
}
参考:https://github.com/facebook/create-react-app/issues/9882