碳信网 Web 项目本地开发指南

环境要求

• Node.js >= 14（建议 16+）
• Yarn >= 1.22

1. 安装依赖

node setup.js

脚本会自动为所有 web 项目创建本地包链接并安装依赖。Windows 和 Mac 通用。

如果网络不稳定，加 --prefer-offline 会优先从本地缓存获取包，速度更快。

2. 启动开发服务

# 以碳门户主页为例
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-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 关联）。