首页手记 React+TS入门教程：轻松搭建你的第一个React项目

React+TS入门教程：轻松搭建你的第一个React项目

标签：

React Typescript

概述

本文详细介绍了如何搭建和开发一个React+TS项目，从安装Node.js和npm开始，到创建React项目并引入TypeScript，配置TypeScript环境，以及基本的语法介绍和项目开发技巧。通过这些步骤，读者可以轻松掌握React+TS的开发流程。

React+TS环境搭建

安装Node.js和npm

在开始开发React+TS项目之前，首先需要安装Node.js和npm。Node.js是一个基于Chrome V8引擎的JavaScript运行时环境，而npm是Node.js的包管理器，用于安装和管理项目所需的依赖包。

访问Node.js官网（https://nodejs.org/）下载并安装最新版本的Node.js。
验证安装是否成功：
- 打开命令行工具（如cmd或终端）。
- 输入以下命令检查Node.js和npm的版本：
```
node -v
npm -v
```
- 如果成功输出版本号，说明安装成功。

创建React项目

使用create-react-app工具可以快速搭建一个React应用。首先，确保已经安装了create-react-app。

使用npm全局安装create-react-app：
```
npm install -g create-react-app
```
创建一个新的React项目：
```
create-react-app my-app
cd my-app
```
启动项目：
```
npm start
```

安装TypeScript

TypeScript是一个由微软开发的开源编程语言，它是JavaScript的超集，提供了静态类型检查等功能，能够帮助开发者减少错误和提高开发效率。接下来，我们将TypeScript引入到React项目中。

首先，确保你的项目中已经安装了typescript。如果还没有安装，可以通过以下命令安装：
```
npm install typescript --save-dev
```
接下来，需要安装@types/react和@types/react-dom，以便在React项目中使用TypeScript：
```
npm install @types/react @types/react-dom --save-dev
```

配置TypeScript

为了使TypeScript可以在React项目中正常使用，需要创建一个TypeScript配置文件tsconfig.json，并进行相应的配置。

在项目根目录下创建tsconfig.json：
```
npx tsc --init
```

根据项目需求修改tsconfig.json。以下是一个基本的配置示例：

{
 "compilerOptions": {
   "target": "es5",
   "module": "commonjs",
   "strict": true,
   "esModuleInterop": true,
   "skipLibCheck": true,
   "forceConsistentCasingInFileNames": true,
   "outDir": "./dist"
 },
 "include": ["src/**/*"],
 "exclude": ["node_modules", "dist"]
}

修改package.json，在scripts部分增加TypeScript编译命令：

"scripts": {
 "start": "react-scripts start",
 "build": "react-scripts build && tsc",
 "test": "react-scripts test",
 "eject": "react-scripts eject",
 "tsc": "tsc"
}

更新项目中的文件扩展名：
- 将App.js文件改为App.tsx。
- 将index.js文件改为index.tsx。
修改tsconfig.json中的include和exclude部分，确保所有源代码文件都被正确包含和排除。
重新启动项目：
```
npm start
```

基本语法介绍

React组件的定义

React组件是React应用的基本组成单元，可以分为类组件和函数组件两种。组件的主要目的是将应用的UI拆解成独立可复用的代码块。

函数组件：
函数组件是使用JavaScript函数定义的组件，通常用于简单的UI逻辑。

// 函数组件示例
const Welcome = (props: { name: string }) => {
 return <h1>Hello, {props.name}!</h1>;
};

类组件：
类组件是通过继承React.Component类定义的组件，通常用于复杂的UI逻辑和状态管理。

// 类组件示例
type Props = {
 name: string;
};

class Welcome extends React.Component<Props> {
 render() {
   return <h1>Hello, {this.props.name}!</h1>;
 }
}

类组件与函数组件的区别

函数组件和类组件在定义方式、生命周期方法、性能和状态管理上有明显区别：

定义方式：
- 函数组件使用箭头函数或普通函数定义。
- 类组件使用React.Component类定义。
生命周期方法：
- 函数组件没有生命周期方法。
- 类组件可以使用各种生命周期方法（如componentDidMount、componentWillUnmount等）。
性能：
- 函数组件通常比类组件更轻量级，渲染速度更快。
- 类组件可能因为生命周期方法的存在而变得复杂。
状态（State）：
- 函数组件通过React.memo等高阶组件或Hooks来管理状态。
- 类组件通过实例方法this.setState管理状态。

TS类型声明的基本规则

定义基本类型：

let name: string = "John Doe";
let age: number = 25;
let isStudent: boolean = true;

定义数组类型：

let numbers: number[] = [1, 2, 3, 4];
let stringArray: Array<string> = ["Apple", "Banana"];

定义对象类型：

type User = {
 name: string;
 age: number;
};

let user: User = {
 name: "Alice",
 age: 30
};

定义函数类型：

let add: (a: number, b: number) => number = (a, b) => a + b;

定义联合类型：

let mixed: string | number = "hello";
mixed = 123;

定义元组类型：

let arr: [number, string] = [1, "world"];

定义枚举类型：

enum Color { Red = 0, Green, Blue };
let backgroundColor: Color = Color.Green;
console.log(backgroundColor); // 输出 "0"

React+TS项目开发

使用Props传递数据

在React组件之间传递数据可以通过Props（属性）来实现。Props是一个对象，包含一个组件需要对外暴露的数据和方法。

定义Props类型：

type Props = {
 name: string;
 age: number;
};

使用Props：

const Profile = (props: Props) => {
 return (
   <div>
     <h1>Profile</h1>
     <p>Name: {props.name}</p>
     <p>Age: {props.age}</p>
   </div>
 );
};

// 在父组件中使用Profile组件
const App = () => {
 return <Profile name="John Doe" age={25} />;
};

状态(State)管理

状态（State）是组件内部的数据，用于存储和管理组件自身的数据。React组件可以通过state和setState方法来管理状态。

定义组件状态：

class Counter extends React.Component {
 state = {
   count: 0
 };

 increment = () => {
   this.setState({ count: this.state.count + 1 });
 };

 render() {
   return (
     <div>
       <h1>Count: {this.state.count}</h1>
       <button onClick={this.increment}>Increment</button>
     </div>
   );
 }
}

使用Hooks管理状态：
您可以使用useState钩子来简化状态管理：

const Counter = () => {
 const [count, setCount] = React.useState(0);

 const increment = () => {
   setCount(count + 1);
 };

 return (
   <div>
     <h1>Count: {count}</h1>
     <button onClick={increment}>Increment</button>
   </div>
 );
};

生命周期方法

React组件的生命周期方法是组件在不同阶段执行的函数，如创建、更新和销毁。

类组件的生命周期方法：

class LifecycleComponent extends React.Component {
 componentDidMount() {
   console.log("Component did mount");
 }

 componentDidUpdate(prevProps: Readonly<Props>, prevState: Readonly<State>, snapshot: any) {
   console.log("Component did update");
 }

 componentWillUnmount() {
   console.log("Component will unmount");
 }

 render() {
   return <div>Hello World</div>;
 }
}

函数组件的生命周期方法：
使用useEffect钩子来替代类组件的生命周期方法：

const LifecycleComponent = () => {
 React.useEffect(() => {
   console.log("Component did mount");
   return () => {
     console.log("Component will unmount");
   };
 }, []);

 React.useEffect(() => {
   console.log("Component did update");
 }, []);

 return <div>Hello World</div>;
};

实战演练

创建一个简单的待办事项列表应用

待办事项列表应用是一个经典的React项目示例，可以展示如何使用React和TypeScript构建一个基本的UI应用。

定义数据类型：

type Todo = {
 id: number;
 text: string;
 completed: boolean;
};

定义状态和方法：

const [todos, setTodos] = React.useState<Todo[]>([
 { id: 1, text: "Learn React", completed: false },
 { id: 2, text: "Learn TypeScript", completed: false }
]);

const addTodo = (text: string) => {
 setTodos([...todos, { id: todos.length + 1, text, completed: false }]);
};

const toggleTodo = (id: number) => {
 setTodos(
   todos.map(todo => {
     if (todo.id === id) {
       return { ...todo, completed: !todo.completed };
     }
     return todo;
   })
 );
};

const [text, setText] = React.useState("");

const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
 setText(e.target.value);
};

渲染UI：

const TodoApp = () => {
 return (
   <div>
     <h1>Todo List</h1>
     <input type="text" value={text} onChange={handleInputChange} />
     <button onClick={() => addTodo(text)}>Add Todo</button>
     <ul>
       {todos.map(todo => (
         <li key={todo.id} style={{ textDecoration: todo.completed ? "line-through" : "" }}>
           <input
             type="checkbox"
             checked={todo.completed}
             onChange={() => toggleTodo(todo.id)}
           />
           {todo.text}
         </li>
       ))}
     </ul>
   </div>
 );
};

高级特性探索

使用React Hooks简化组件逻辑

React Hooks是React 16.8版本引入的新特性，它们允许在不编写类组件的情况下使用某些特性，如状态管理、生命周期等。

使用useState管理状态：

const Counter = () => {
 const [count, setCount] = React.useState(0);

 const increment = () => {
   setCount(count + 1);
 };

 return (
   <div>
     <h1>Count: {count}</h1>
     <button onClick={increment}>Increment</button>
   </div>
 );
};

使用useEffect处理副作用：

const Counter = () => {
 const [count, setCount] = React.useState(0);

 React.useEffect(() => {
   console.log("Component did mount");
   return () => {
     console.log("Component will unmount");
   };
 }, []);

 React.useEffect(() => {
   console.log("Component did update");
 }, [count]);

 return (
   <div>
     <h1>Count: {count}</h1>
     <button onClick={() => setCount(count + 1)}>Increment</button>
   </div>
 );
};

使用useContext管理全局状态：

const themeContext = React.createContext("dark");

const App = () => {
 const [theme, setTheme] = React.useState("dark");

 return (
   <themeContext.Provider value={theme}>
     <ThemeToggle setTheme={setTheme} />
     <ThemeDisplay />
   </themeContext.Provider>
 );
};

const ThemeToggle = (props: { setTheme: (theme: string) => void }) => {
 return <button onClick={() => props.setTheme(props.theme === "dark" ? "light" : "dark")}>Toggle Theme</button>;
};

const ThemeDisplay = () => {
 const theme = React.useContext(themeContext);
 return <p>Current theme is {theme}</p>;
};

代码分割和懒加载

代码分割和懒加载可以帮助提高应用的性能，通过按需加载代码来减少应用的初始加载时间。

使用动态导入：

const App = () => {
 return (
   <div>
     <h1>App</h1>
     <button onClick={() => import("./LazyComponent").then(({ LazyComponent }) => setComponent(LazyComponent))}>
       Load Lazy Component
     </button>
     {component}
   </div>
 );
};

配置Webpack进行代码分割：
在webpack.config.js中配置代码分割：

module.exports = {
 //...
 optimization: {
   splitChunks: {
     chunks: "async",
     minSize: 30000,
     maxSize: 0,
     minChunks: 1,
     maxAsyncRequests: 5,
     maxInitialRequests: 3,
     automaticNameDelimiter: "~",
     name: true,
     cacheGroups: {
       default: {
         minChunks: 4,
         priority: 4,
         reuseExistingChunk: true
       },
       vendor: {
         test: /[\\/]node_modules[\\/]/,
         priority: 10
       }
     }
   }
 }
};

TypeScript的类型推断和泛型

TypeScript的类型推断可以帮助简化代码，编译器会根据上下文自动推断类型。泛型则允许编写可复用的组件代码。

类型推断：

const add = (a: number, b: number) => a + b;
add(1, 2); // TypeScript会推断类型为number => number

使用泛型：

type Identity<T> = {
 value: T;
};

const identity = <T>(value: T) => ({ value });

const stringIdentity = identity<string>("Hello"); // 类型为Identity<string>
const numberIdentity = identity<number>(42); // 类型为Identity<number>

调试和优化

使用React Developer Tools调试应用

React Developer Tools是Chrome和Firefox浏览器的插件，可以方便地查看和调试React组件树。

安装插件：
- 在Chrome中，访问Chrome网上应用店搜索“React Developer Tools”。
- 在Firefox中，访问Firefox插件市场搜索“React Developer Tools”。
使用插件：
- 安装后，在浏览器开发者工具中打开“React”标签页。
- 可以查看当前渲染的组件树，双击组件节点可以查看组件的props和state。

优化TypeScript配置提高开发效率

TypeScript配置文件tsconfig.json可以进行各种优化，提高开发效率。

调整编译选项：
- target：指定编译目标版本。
- module：指定模块的类型（如commonjs、esnext）。
- strict：启用严格的类型检查。
- skipLibCheck：跳过库文件的类型检查，提高编译速度。
优化文件包含和排除：
- include：指定需要包含的文件路径。
- exclude：指定需要排除的文件路径。
使用tslint或eslint进行代码格式化和规范检查：
```
npm install --save-dev tslint eslint
```

配置tslint.json或.eslintrc.json：

{
 "extends": "tslint:recommended",
 "rules": {
   "no-console": "warn",
   "no-unused-variable": "error",
   "interface-name": "check-namespace"
 }
}

通过以上步骤，可以搭建和开发一个完整的React+TS项目。从环境搭建到基本语法介绍，再到项目开发和高级特性探索，最后到调试和优化，每个步骤都已详细展开，并提供了必要的代码示例。希望本教程能够帮助你轻松入门React+TS开发。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

qq_遁去的一_1

手记
篇

粉丝

7

获赞与收藏

23

关注作者，订阅最新文章

阅读免费教程

TypeScript 入门教程

38个小节 93068 666

后端通用面试教程

41个小节 30585 343

网络编程入门教程

20个小节 12562 237

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空