53 lines
1.3 KiB
Markdown
53 lines
1.3 KiB
Markdown
# 碳信网 Web 项目本地开发指南
|
||
|
||
## 环境要求
|
||
|
||
- Node.js >= 14（建议 16+）
|
||
- Yarn >= 1.22
|
||
|
||
## 1. 安装依赖
|
||
|
||
```bash
|
||
node setup.js
|
||
```
|
||
|
||
脚本会自动为所有 web 项目创建本地包链接并安装依赖。Windows 和 Mac 通用。
|
||
|
||
> 如果网络不稳定，加 `--prefer-offline` 会优先从本地缓存获取包，速度更快。
|
||
|
||
## 2. 启动开发服务
|
||
|
||
```bash
|
||
# 以碳门户主页为例
|
||
cd txw-mhzc-web
|
||
yarn dev
|
||
```
|
||
|
||
其他项目同理：`txw-gxzx-web`、`txw-kxtfwzx-web`、`txw-tzzx-web`、`txw-ytzx-web`、`txw-yygl-web`
|
||
|
||
## 3. 项目说明
|
||
|
||
| 目录 | 说明 |
|
||
|------|------|
|
||
| `txw-gxzx-web` | 个人工作台 |
|
||
| `txw-kxtfwzx-web` | 科学碳体重中心 |
|
||
| `txw-mhzc-web` | 碳门户主页 |
|
||
| `txw-tzzx-web` | 碳资讯 |
|
||
| `txw-ytzx-web` | 碳云学堂 |
|
||
| `txw-yygl-web` | 运营管理 |
|
||
| `local-nodemodules` | 本地私有包（ggzc-web 组件库） |
|
||
|
||
## 4. 常见问题
|
||
|
||
**Q: yarn install 报 `@cssyq/ggzc-web` not found？**
|
||
|
||
A: 需要先建立 symlink。执行第 1 步中的 for 循环即可。
|
||
|
||
**Q: 启动报错 engine node incompatibility？**
|
||
|
||
A: 加 `--ignore-engines` 参数绕过。
|
||
|
||
**Q: 需要更新 ggzc-web 组件库？**
|
||
|
||
A: 修改 `local-nodemodules/@cssyq/ggzc-web` 后，直接 `yarn dev` 即可看到更新（已通过 symlink 关联）。
|