vue-element-plus-admin(vue3)二次开发入门指南(2)-修改开发启动端口,改项目名等配置项,删除启动页面提示
把准备好的代码导入到在vscode IDE里

选择自己的本地代码根文件夹后如下图所示

项目目录结构
.
├── .github # github workflows 相关
├── .husky # husky 配置
├── .vscode # vscode 配置
├── mock # 自定义 mock 数据及配置
├── public # 静态资源
├── src # 项目代码
│ ├── api # api接口管理
| |── axios # axios配置
│ ├── assets # 静态资源
│ ├── components # 公用组件
│ ├── constants # 存放常量
│ ├── hooks # 常用hooks
│ ├── layout # 布局组件
│ ├── locales # 语言文件
│ ├── plugins # 外部插件
│ ├── router # 路由配置
│ ├── store # 状态管理
│ ├── styles # 全局样式
│ ├── utils # 全局工具类
│ ├── views # 路由页面
│ ├── App.vue # 入口vue文件
│ ├── main.ts # 主入口文件
│ └── permission.ts # 路由拦截
├── types # 全局类型
├── .env.base # 本地开发环境 环境变量配置
├── .env.dev # 打包到开发环境 环境变量配置
├── .env.gitee # 针对 gitee 的环境变量 可忽略
├── .env.pro # 打包到生产环境 环境变量配置
├── .env.test # 打包到测试环境 环境变量配置
├── .eslintignore # eslint 跳过检测配置
├── .eslintrc.js # eslint 配置
├── .gitignore # git 跳过配置
├── .prettierignore # prettier 跳过检测配置
├── .stylelintignore # stylelint 跳过检测配置
├── .versionrc 自动生成版本号及更新记录配置
├── CHANGELOG.md # 更新记录
├── commitlint.config.js # git commit 提交规范配置
├── index.html # 入口页面
├── package.json
├── .postcssrc.js # postcss 配置
├── prettier.config.js # prettier 配置
├── README.md # 英文 README
├── README.zh-CN.md # 中文 README
├── stylelint.config.js # stylelint 配置
├── tsconfig.json # typescript 配置
├── vite.config.ts # vite 配置
└── uno.config.ts # unocss 配置
IDE里启动项目
点击Terminal下面的New Terminal就会启动一个终端


在终端里使用命令启动项目
pnpm run dev
在终端里出现类似如下的内容,就可以在浏览器中输入local地址观察内容了

修改项目成固定自定义端口
在项目根目录下找到vite.config.ts文件并修改server标签下的port数值
注意:这个是本地开发的端口,等讲解发布的时候再详细介绍,如果端口末尾是0,启动端口会自动加1(很奇怪的问题)

再浏览器输入http://localhost:9801得到如下图所示

环境变量配置
项目的环境变量配置位于项目根目录下的,这里主要配置四个个环境变量,分别为:
在开发调试的时候,会读取 .env.base 里面的数据。其他环境亦是如此,根据打包命令的不同,来读取不同的环境变量。
也许你会疑惑,为什么会有多个环境变量?
以 生产环境 为例,当我们执行 pnpm run build:pro 时,输出的包是用于线上环境的,所以代码都应该是压缩,我们需要删除掉代码中的 console.log 和 degubber,保证打包后代码的整洁度和不可见性。而其他环境,所以应该保留 console.log 和 degubber 用于调试,这样才能快速定位到问题所在。
所以环境变量的作用就是为了,在不同环境下有不同的表现。
提示
- 只有以
VITE_开头的变量会被嵌入到项目中,你可以项目代码中这样访问它们:
console.log(import.meta.env.VITE_APP_TITLE)
配置项说明
.env.base
本地开发环境适用
# 环境
NODE_ENV = development
# 接口前缀
VITE_API_BASEPATH = base
# 打包路径
VITE_BASE_PATH = /
# 标题
VITE_APP_TITLE = ElementAdmin
.env.dev
开发环境适用
# 环境
NODE_ENV = production
# 接口前缀
VITE_API_BASEPATH = dev
# 打包路径
VITE_BASE_PATH = /dist-dev/
# 是否删除debugger
VITE_DROP_DEBUGGER = false
# 是否删除console.log
VITE_DROP_CONSOLE = false
# 是否sourcemap
VITE_SOURCEMAP = true
# 输出路径
VITE_OUT_DIR = dist-dev
# 标题
VITE_APP_TITLE = ElementAdmin
.env.test
测试环境适用
# 环境
NODE_ENV = production
# 接口前缀
VITE_API_BASEPATH = test
# 打包路径
VITE_BASE_PATH = /dist-test/
# 是否删除debugger
VITE_DROP_DEBUGGER = false
# 是否删除console.log
VITE_DROP_CONSOLE = false
# 是否sourcemap
VITE_SOURCEMAP = true
# 输出路径
VITE_OUT_DIR = dist-test
.env.pro
生产环境适用
# 环境
NODE_ENV = production
# 接口前缀
VITE_API_BASEPATH = pro
# 打包路径
VITE_BASE_PATH = /
# 是否删除debugger
VITE_DROP_DEBUGGER = true
# 是否删除console.log
VITE_DROP_CONSOLE = true
# 是否sourcemap
VITE_SOURCEMAP = false
# 输出路径
VITE_OUT_DIR = dist-pro
# 标题
VITE_APP_TITLE = ElementAdmin
修改项目名称
在项目根目录下找到如下相应的配置文件
只需要修改项目配置项中的VITE_APP_TITLE = ElementAdmin 选项,我们可以修改为我们需要的名字,我们只在.env.base 配置里做演示,其他环境配置是一样的
# 环境
VITE_NODE_ENV=development
# 接口前缀
VITE_API_BASE_PATH=
# 打包路径
VITE_BASE_PATH=/
# 标题
VITE_APP_TITLE=二次开发测试
# 是否全量引入element-plus样式
VITE_USE_ALL_ELEMENT_PLUS_STYLE=true
# 是否开启mock
VITE_USE_MOCK=true
# 是否使用在线图标
VITE_USE_ONLINE_ICON=true
# 是否隐藏全局设置按钮
VITE_HIDE_GLOBAL_SETTING=false
保存后项目会自动重启生效,我们只需要在浏览器中刷新以下就可以看到修改的效果了

登录后效果

删除页面启动时的提示
当我们启动页面的时候,页面上面会有一个没有用提示如图
如果想要删除这个提示需要以下操作
找到文件src/App.vue
在文件里注释掉提示 的代码如下图所示

注释后我们再进入系统页面的时候就没有了提示框,如图所示

更多推荐


所有评论(0)