Geeker-Admin 常见问题解决方案

项目基础介绍和主要编程语言

Geeker-Admin 是一款基于 Vue3.4、TypeScript、Vite5、Pinia、Element-Plus 的开源后台管理框架。该项目使用最新的技术栈开发，提供了强大的 ProTable 组件，旨在提高开发效率。主要编程语言包括 TypeScript 和 JavaScript。

新手使用注意事项及解决方案

1. 环境配置问题

问题描述：新手在克隆项目后，可能会遇到环境配置不正确的问题，导致项目无法正常运行。

解决步骤：

1. 检查 Node.js 版本：确保你的 Node.js 版本符合项目要求。建议使用 LTS 版本。
2. 安装依赖：在项目根目录下运行 pnpm install 安装所有依赖。
3. 配置环境变量：根据项目文档，配置 .env 文件中的环境变量。

2. 路由权限配置问题

问题描述：新手在使用 VueRouter 配置动态路由权限时，可能会遇到权限拦截或路由懒加载的问题。

解决步骤：

1. 检查路由配置：确保 src/router/index.ts 中的路由配置正确，特别是权限相关的配置。
2. 动态路由加载：确保动态路由的加载逻辑正确，可以在 src/router/asyncRoutes.ts 中进行调试。
3. 权限拦截：在 src/permission.ts 中配置权限拦截逻辑，确保用户权限与路由匹配。

3. 代码格式化和校验问题

问题描述：新手在提交代码时，可能会遇到 ESLint、Prettier 或 Stylelint 的代码格式化和校验问题。

解决步骤：

1. 安装 VSCode 插件：推荐安装 ESLint、Prettier 和 Stylelint 插件，以便在编辑器中实时校验代码。
2. 运行校验命令：在项目根目录下运行以下命令进行代码校验：
   • pnpm lint:eslint：ESLint 检测代码
   • pnpm lint:prettier：Prettier 格式化代码
   • pnpm lint:stylelint：Stylelint 格式化样式
3. 提交代码：在提交代码前，确保所有校验通过，可以使用 pnpm commit 命令进行提交。

通过以上步骤，新手可以更好地理解和使用 Geeker-Admin 项目，避免常见问题的发生。