Spaces:
Runtime error
Runtime error
feat: update fe readme (#14)
Browse files* feat: update fe readme
* feat: fe readme
---------
Co-authored-by: fangfang <[email protected]>
- frontend/React/README.md +106 -18
- frontend/React/windows-.png +0 -0
frontend/React/README.md
CHANGED
@@ -1,30 +1,120 @@
|
|
1 |
-
|
|
|
|
|
2 |
|
3 |
-
###
|
|
|
4 |
|
5 |
-
|
6 |
|
7 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
8 |
|
9 |
-
|
|
|
|
|
10 |
|
11 |
-
|
12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
13 |
```
|
|
|
|
|
|
|
|
|
|
|
|
|
14 |
|
15 |
-
|
16 |
-
|
17 |
-
npm start
|
18 |
```
|
19 |
-
|
|
|
|
|
20 |
|
21 |
-
|
|
|
|
|
|
|
|
|
|
|
22 |
|
23 |
-
|
24 |
|
25 |
-
|
|
|
26 |
|
27 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
28 |
|
29 |
```
|
30 |
server: {
|
@@ -38,7 +128,5 @@ npm start
|
|
38 |
}
|
39 |
```
|
40 |
|
41 |
-
|
42 |
-
### 知悉
|
43 |
-
|
44 |
- 前端服务基于react开发,如需了解react相关知识,可参考:https://react.dev/
|
|
|
1 |
+
# 开始
|
2 |
+
## 准备node.js开发环境
|
3 |
+
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境,允许你在服务器端运行 JavaScript。以下是在 Windows、Linux 和 macOS 上安装 Node.js 的详细步骤。
|
4 |
|
5 |
+
### 在 Windows 上安装 Node.js
|
6 |
+
- 步骤 1: 访问 Node.js 官网
|
7 |
|
8 |
+
打开浏览器,访问 [Node.js](https://nodejs.org/zh-cn/download/prebuilt-installer) 官方网站。
|
9 |
|
10 |
+
- 步骤 2: 下载 Node.js 安装包
|
11 |
+
|
12 |
+
选择你需要的nodejs版本,设备的类型,点击下载,示例如下图:
|
13 |
+
![windows install](./windows-.png)
|
14 |
+
|
15 |
+
- 步骤 3: 安装 Node.js
|
16 |
+
|
17 |
+
双击下载的安装包开始安装。
|
18 |
+
|
19 |
+
跟随安装向导的指示进行安装。在安装过程中,你可以选择安装位置、是否将 Node.js 添加到系统 PATH 环境变量等选项。推荐选择“添加到 PATH”以便在任何地方都能通过命令行访问 Node.js。
|
20 |
+
安装完成后,点击“Finish”结束安装。
|
21 |
+
|
22 |
+
- 步骤 4: 验证安装
|
23 |
+
|
24 |
+
打开命令提示符(CMD)或 PowerShell。
|
25 |
+
输入 node -v 并回车,如果系统返回了 Node.js 的版本号,说明安装成功。
|
26 |
+
接着,输入 npm -v 并回车,npm 是 Node.js 的包管理器,如果返回了版本号,表示 npm 也已正确安装。
|
27 |
+
|
28 |
+
### 在 Linux 上安装 Node.js
|
29 |
+
注意: 由于 Linux 发行版众多,以下以 Ubuntu 为例说明,其他发行版(如 CentOS、Debian 等)的安装方式可能略有不同,可自行查询对应的安装办法。
|
30 |
+
|
31 |
+
- 步骤 1: 更新你的包管理器
|
32 |
+
|
33 |
+
打开终端。
|
34 |
+
|
35 |
+
输入 sudo apt update 并回车,以更新 Ubuntu 的包索引。
|
36 |
+
|
37 |
+
- 步骤 2: 安装 Node.js
|
38 |
+
|
39 |
+
对于 Ubuntu 18.04 及更高版本,Node.js 可以直接从 Ubuntu 的仓库中安装。
|
40 |
+
输入 sudo apt install nodejs npm 并回车。
|
41 |
+
对于旧版本的 Ubuntu 或需要安装特定版本的 Node.js,你可能需要使用如 NodeSource 这样的第三方仓库。
|
42 |
+
|
43 |
+
- 步骤 3: 验证安装
|
44 |
+
|
45 |
+
在终端中,输入 node -v 和 npm -v 来验证 Node.js 和 npm 是否已正确安装。
|
46 |
+
|
47 |
+
### 在 macOS 上安装 Node.js
|
48 |
+
|
49 |
+
#### 下载安装
|
50 |
+
- 步骤 1: 访问 Node.js 官网
|
51 |
+
|
52 |
+
打开浏览器,访问 Node.js 官方网站。
|
53 |
+
|
54 |
+
- 步骤 2: 下载 Node.js 安装包
|
55 |
+
|
56 |
+
在首页找到 macOS 对应的安装包(通常是 .pkg 文件),点击下载。
|
57 |
+
|
58 |
+
- 步骤 3: 安装 Node.js
|
59 |
|
60 |
+
找到下载的 .pkg 文件,双击打开。
|
61 |
+
跟随安装向导的指示进行安装。
|
62 |
+
安装完成后,点击“Close”结束安装。
|
63 |
|
64 |
+
- 步骤 4: 验证安装
|
65 |
+
|
66 |
+
打开终端。
|
67 |
+
|
68 |
+
输入 node -v 和 npm -v 来验证 Node.js 和 npm 是否已正确安装。
|
69 |
+
|
70 |
+
#### 使用HomeBrew安装
|
71 |
+
前提条件:确保你的macOS上已经安装了Homebrew。如果尚未安装,可以通过以下命令进行安装(以终端操作为例):
|
72 |
```
|
73 |
+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
74 |
+
```
|
75 |
+
按照提示输入密码以确认安装。安装过程中,可能需要你同意许可协议等。
|
76 |
+
|
77 |
+
- 打开终端:
|
78 |
+
在macOS上找到并打开“终端”应用程序。
|
79 |
|
80 |
+
- 使用Homebrew安装Node.js:
|
81 |
+
在终端中输入以下命令来安装最新版本的Node.js
|
|
|
82 |
```
|
83 |
+
brew install node
|
84 |
+
```
|
85 |
+
Homebrew会自动下载Node.js的安装包,并处理相关的依赖项和安装过程。你需要等待一段时间,直到安装完成。
|
86 |
|
87 |
+
- 验证安装:
|
88 |
+
安装完成后,你可以通过输入以下命令来验证Node.js是否成功安装:
|
89 |
+
```
|
90 |
+
node -v
|
91 |
+
```
|
92 |
+
如果终端输出了Node.js的版本号,那么表示安装成功。同时,你也可以通过输入npm -v来验证npm(Node.js的包管理器)是否也成功安装。
|
93 |
|
94 |
+
完成以上步骤后,你应该能在你的 Windows、Linux 或 macOS 系统上成功安装并运行 Node.js。
|
95 |
|
96 |
+
### 更多
|
97 |
+
如需了解更多,可参照:https://nodejs.org/en
|
98 |
|
99 |
+
如环境已经准备好,跳转下一步
|
100 |
+
|
101 |
+
## 安装依赖
|
102 |
+
进入前端项目根目录
|
103 |
+
```
|
104 |
+
npm install
|
105 |
+
```
|
106 |
+
|
107 |
+
## 启动
|
108 |
+
```
|
109 |
+
npm start
|
110 |
+
```
|
111 |
+
|
112 |
+
启动成功后,界面将出现可访问的本地url
|
113 |
+
|
114 |
+
## 配置
|
115 |
+
### 接口请求配置
|
116 |
+
- 如您需要配置的服务支持跨域,可至/src/config/cgi.ts中修改请求链接,请求链接为http://ip:port/path;
|
117 |
+
- 如您需要配置的服务不支持跨域,可至vite.config.ts中配置proxy,示例如下:
|
118 |
|
119 |
```
|
120 |
server: {
|
|
|
128 |
}
|
129 |
```
|
130 |
|
131 |
+
## 知悉
|
|
|
|
|
132 |
- 前端服务基于react开发,如需了解react相关知识,可参考:https://react.dev/
|
frontend/React/windows-.png
ADDED
![]() |