\346\234\254\345\234\260\345\211\215\347\253\257\351\241\271\347\233\256\346\233\264\346\226\260 iidp \345\271\263\345\217\260\344\276\235\350\265\226\347\211\210\346\234\254\346\214\207\345\215\227.md
... ...
@@ -0,0 +1,54 @@
1
+# 本地前端项目更新 iidp 平台依赖版本指南
2
+
3
+## 一、文档说明
4
+
5
+本文档用于指导如何更新前端项目中依赖的 iidp 平台相关包（包括 `@tech/t-core`、`@tech/t-el-ui`、`@tech/t-build`、`@tech/t-base`前端底座依赖），涵盖「更新至最新版本」和「指定版本更新」两种场景。
6
+
7
+
8
+## 二、更新至最新版本
9
+
10
+若需将依赖更新为当前最新版本，操作步骤如下：
11
+
12
+1. 直接执行 `package.json` 中定义的 `update:xxx` 脚本（`xxx` 为具体脚本名称），该脚本会自动安装对应依赖的最新版本：
13
+
14
+ ```bash
15
+ npm run update:xxx
16
+ ```
17
+
18
+
19
+## 三、更新至指定版本
20
+
21
+若需精确指定依赖版本（非最新版本），操作步骤如下：
22
+
23
+1. **修改版本配置**
24
+ 在 `package.json` 的 `dependencies`（全小写） 中找到目标依赖，按以下规则修改：
25
+
26
+ - `移除`版本号前的 `^` 符号（`^` 会影响版本匹配范围）；
27
+ - 将版本号替换为目标指定版本（例如：将 `^2.15.12` 改为 `2.15.12`）。
28
+
29
+
30
+ > `package.json` 中依赖版本号前的 `^` 用于定义版本兼容范围：
31
+ >
32
+ > - 含义：允许安装「大于等于当前版本，且小于下一个主版本」的更新；
33
+ > - 示例：`^2.15.12` 允许安装 `2.15.13`、`2.16.0` 等版本，但不允许安装 `3.0.0`（主版本号升级）。
34
+
35
+
36
+2. **执行安装命令**
37
+ 运行 `install:tech` 脚本安装指定版本：
38
+
39
+ ```
40
+ npm run install:tech
41
+ ```
42
+
43
+ ```
44
+ "install:tech": "npm i @tech/t-core @tech/t-el-ui @tech/t-build @tech/t-base -S --registry http://iidp.chinasie.com:9999/maven/repository/npm-group/",
45
+ ```
46
+
47
+
48
+
49
+3. **版本号自动恢复说明**
50
+ 安装成功后，`package.json/dependencies` 中依赖的版本号会自动重新添加 `^` 符号，此为正常现象。
51
+
52
+#### 注意：
53
+
54
+更新版本后需要重新启动前端项目。