# base_front **Repository Path**: qinshouzhi/base_front ## Basic Information - **Project Name**: base_front - **Description**: 为前端项目提供模块化、标准化的基础纯净开发框架,方便定制化开发 - **Primary Language**: NodeJS - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2022-05-08 - **Last Updated**: 2022-05-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # base_front **为 `后端开发` 学习前端项目提供模块化、标准化的基础纯净开发框架,方便定制化开发。** > - 为方便学习高版本依赖应用,本项目会融合vue2.X和vue3.X的多种写法 > - 所有的依赖都是基于vue的主体版本选择比较新的比较稳定的搭配方案,力求控制台不见一点红。 > - 开源组件采用 `ant-design-vue` , 相较于 `Element-ui` 虽比较复杂,但是组件多啊,方便实现 更多定制化需求。 无法持续更新,本人作为后端开发,在学到新东西就更新下,主要用于大家小项目的学习以及开发 欢迎前端大佬提供学习优化建议!!! **提供:** - 模块化国际化配置 - 模块化路由配置 - 模块化VueX配置 - 模块化Api配置 - 便捷开发组件及使用文档(README.md) - 必要工具类(有新的就会加上……持续更新) | 位置 | 说明 | | ---------------------------- | ------------------------------------- | | src/utils/sm2/sm2.js | sm2加密 | | src/utils/sm2/sm3.js | sm3加密 | | src/utils/date.js | 日期工具类 | | src/utils/request.js | http工具类 | | src/utils/browser.js | 浏览器工具 | | src/utils/common.js | 通用工具 | - 必要的全局 变量(有新的就会加上……持续更新) | 调用名 | 说明 | | ---------------------------- | ------------------------------------- | | $axios | 原生的axios | | $config | 全文配置 | --- ## 项目启动 想要开发环境启动很简单,项目拉下来,npm install完npm run serve,前置条件是有node环境(本人开发环境都是node12及以上的版本), 为确保依赖的一致性请不要随意修改 `package-lock.json` ``` npm install 下载依赖 npm run serve 启动项目 npm run build 打包项目 npm run test npm run lint ``` ## 项目一级目录及文件说明 | 文件夹或文件名 | 说明 | | ---------------------------- | -------------------------------------- | | public | 不打包成模块的公共文件 | | src | 核心代码及配置文件 | | .browserslistrc | 浏览器适配文件 | | .env | 项目环境变量配置文件 | | .eslintignore | eslint代码规范校验的忽略配置文件 | | .eslintrc.js | eslint代码规范校验的配置规则文件 | | .gitignore | git提交忽略文件 | | babel.config.js | Babel JS编译器的配置文件 | | jsconfig.json | JS项目根目录的指向性文件 | | LICENSE | 开源文件 | | package.json | 版本依赖控制文件 | | package-lock.json | 版本依赖锁定文件 | | vue.config.js | 核心配置文件(打包,代理,解析器。。。) | ## 项目的使用和配置 ### 1、名称配置 修改`.env`配置文件下的`VUE_APP_TITLE`的值 ``` VUE_APP_TITLE=项目名称 ``` ### 2、项目端口配置 修改`vue.config.js`中`devServer.port`的值,默认端口8001 ``` devServer: { port: 8001 } ``` ### 3、项目基础路径及接口基础前缀配置 修改 `.env` 配置文件下的 `BASE_URL` 的值,配置完后项目启动的基础路径就是 `http://127.0.0.1:8001/base` 同时所有的接口路径都会默认带有基础路径, ``` BASE_URL=/base ``` ### 4、Api接口代理配置 详细接口请求配置请参考 `src/api/README.md` ### 5、路由配置 详细路由配置请参考 `src/router/README.md` ### 6、全局配置文件 修改 `src/config/settings.js` 全局获取 `$config` ### 7、I18n国际化配置 请参考 `src/locales/README.md` ### 8、vuex使用与配置 请参考 `src/store/README.md` #### 8.1、 已配置项 | 配置项 | 说明 | | --------------------------------- | ------------------------------------- | | this.$store.state.qLanguageSelect | 当前选择的国际化语言 | | this.$store.state.userInfo | 当前登录的用户信息 | ### 9、组件使用 参考 `src/components` 下每个文件夹各自的 `README.md` 文件