Gitcx框架文档

常见问题

• node 版本请安装官网最新正式版 14，node 版本小于 12 无法运行此项目

• 包管理工具建议使用 cnpm 或 pnpm，使用 npm 或 yarn 安装可能导致图片压缩依赖无法正常安装

# 开发建议删除的功能

布局与主题冗余会导致项目体积较大，访问速度变慢，故建议您选定一种布局或主题后删除其余不需要的布局和主题代码，加快网站访问速度

• src/vab/layouts 下的布局为松耦合，项目上线时建议删掉 layouts 下使用不到的布局，将大大减小打包体积，加快网站访问速度

• src/vab/vab/styles/themes下的主题文件体积较大，项目上线时如果没有换肤需求建议删掉 styles 下使用不到的主题，将大大减小打包体积，加快网站访问速度

• 注意事项：vertical 布局不可删除因为手机端依赖于 vertical 布局

• 主题配置功能繁琐，强烈不建议将太多的可选项交到用户手中（一旦让用户看到你会增加很多额外的工作，没有没事，一旦被看到，用户可能会无限追求完美，徒增工作量），如果没有极特殊的强烈要求建议将以下功能设置为 false

module.exports = {
  // 是否开启语言选择组件
  showLanguage: false,
  // 是否开启刷新组件
  showRefresh: false,
  // 是否开启搜索组件
  showSearch: false,
  // 是否开启主题组件
  showTheme: false,
  // 是否开启通知组件
  showNotice: false,
  // 是否开启全屏组件
  showFullScreen: false,
  // 是否开启右侧悬浮窗
  showThemeSetting: false,
};

# 打包时建议注释掉的功能

• 由于 pro 演示环境使用的是 mock.js，而非真实的后端，在你打包时需要注意注释掉`src/main.js'下相关的 mock 代码

• 打包后报Uncaught SyntaxError: Unexpected token u in JSON at position 0，大部分是没有注册 mock 造成的

/**
 * @author chuzhixin 1204505056@qq.com
 * @description 正式环境默认使用mock，正式项目记得注释后再打包
 */
/* if (process.env.NODE_ENV === "production") {
  const { mockXHR } = require("@/utils/static");
  mockXHR();
} */

# 打包时可能遇到的常见错误

• 打包报错 Cannot find module 'gifsicle'或 Cannot find module 'pngquan' 方案 1：请使用使用 cnpm 安装，一定 cnpm 安装

# 项目根目录
cnpm i image-webpack-loader -D

方案 2：修改 hosts（推荐）

• 管理员打开C:\Windows\System32\drivers\etc\host，最后一行填入199.232.68.133 raw.githubusercontent.com保存即可

方案 3：去src/config/cli.config.js关闭图片压缩

/**
 * @description 导出vue/cli配置，以下所有配置修改需要重启项目
 */
module.exports = {
  // npm run build时是否开启图片压缩，由于国内网路原因image-webpack-loader必须使用cnpm安装，如无法使用cnpm，请配置false
  imageCompression: false,
};

• 打包提示未配置秘钥

• 打包提示秘钥失效请填写VUE_APP_SECRET_KEY=XXXXXXXX==（购买时提供，如未提供联系客服） 秘钥到 .env.local 中

打包命令