ant Descriptions 描述列表 接接口返回对象数据渲染

拉钩电商项目说明

1. 技术栈

1.1 客户端

• 脚本：TypeScript
• 前端框架：React
• 路由管理：React-router-dom
• 用户界面：Antd
• 全局状态管理：Redux
• 异步状态更新：redux-saga
• 路由状态同步：connected-react-router
• 网络请求：Axios
• 调试工具：redux-devtools-extension

1.2 服务端

• 脚本：Node.js
• 数据库：Mongodb
• 数据库可视化：Robo 3T

2. 搭建开发环境 (服务端)

2.1 安装 mongodb 数据库 (Mac)

1. 安装 homebrewHomebrew 是mac系统中的软件包管理器

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

1. 添加 mongodb 仓库源

brew tap mongodb/brew

1. 安装 mongodb
   安装前确保系统已经安装 xcode 命令行编译开发工具

xcode-select --install

brew install mongodb-community

1. 启动 mongodb

brew services run mongodb-community

1. 停止 mongodb

brew services stop mongodb-community

1. 文件位置

1. 数据库配置文件：/usr/local/etc/mongod.conf
2. 数据库文件默认存放位置：/usr/local/var/mongodb
3. 日志存放位置：/usr/local/var/log/mongodb/mongo.log

2.2 安装 mongodb 数据库 (Windows)

2.3 数据库可视化 Robo 3T

下载地址

2.4 启动服务器端应用程序

1. Mac 用户将服务器端应用程序文件夹拖拽到终端中，windows 用户打开服务器端应用程序文件夹，按住 shift 同时单击鼠标右键，选择在此处打开命令行工具 (cmd 或者 powershell)
2. 执行 npm install 命令安装程序依赖文件
3. 执行 npm start 命令启动服务器端应用程序，服务器端应用程序默认监听 80 端口

3. 搭建开发环境 (客户端)

3.1 创建项目并安装依赖

1. 使用 create-react-app 脚手架创建 react 项目
   npx create-react-app ecommerce-front --template typescript
2. 安装项目依赖
   npm install antd axios moment redux react-redux react-router-dom redux-saga connected-react-router redux-devtools-extension @types/react-redux @types/react-router-dom
3. antd CSS 使用 CDN
   https://cdn.bootcdn.net/ajax/libs/antd/4.8.3/antd.min.css

3.2 配置服务器端 API 请求地址

在项目的根目录下新建 .env 文件，并在文件中添加以下内容：

REACT_APP_PRODUCTION_API_URL=http://fullstack.net.cn/api
REACT_APP_DEVLOPMENT_API_URL=http://localhost/api

create-react-app 脚手架中内置了 dotenv，允许我们在 React 项目中配置环境变量，但环境变量的名字必须以 REACT_APP_ 开头。

REACT_APP_PRODUCTION_API_URL： 生产环境的服务器端 API 地址

REACT_APP_DEVLOPMENT_API_URL：开发环境的服务器端 API 地址

在项目中可以通过 process.env.REACT_APP_DEVLOPMENT_API_URL 方式进行访问，但是这样会有弊端，其一是代码过长写起来不方便，其二是如果在代码中将环境写死，当切换环境时改起来也不方便。

解决方案就是将 API 地址写入配置中，根据环境决定使用哪个 API 地址

export let API: string

if (process.env.NODE_ENV === "development") {
  API = process.env.REACT_APP_DEVLOPMENT_API_URL!
} else {
  API = process.env.REACT_APP_PRODUCTION_API_URL!
}

3.3 安装 chrome 扩展

React Developer Tools：检查React组件层次结构，在页面上显示React组件。

Redux DevTools：监测 Store 中状态的变化

import { composeWithDevTools } from "redux-devtools-extension"

export const store = createStore(
  rootReducer,
  composeWithDevTools(applyMiddleware(...middlewares))
)