pure-admin-thin 项目常见问题解决方案

项目基础介绍

pure-admin-thin 是基于 vue-pure-admin 提炼出的精简版项目，主要用于实际项目开发。它包含了主体功能，打包后的大小在全局引入 element-plus 的情况下仍然低于 2.3MB。该项目会永久同步完整版的代码，并且支持开启 brotli 压缩和 cdn 替换本地库模式，使得打包大小低于 350kb。

主要的编程语言包括：

• TypeScript
• Vue
• SCSS
• JavaScript
• CSS
• HTML

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

1. 项目依赖安装问题

问题描述：新手在克隆项目后，可能会遇到依赖安装失败的问题，尤其是在使用 pnpm 或 npm 安装依赖时。

解决步骤：

1. 检查网络连接：确保网络连接正常，能够访问外网。
2. 使用镜像源：如果网络不稳定，可以尝试使用国内的 npm 镜像源，例如：

   npm config set registry https://registry.npmmirror.com
   

3. 清理缓存：如果之前安装失败，可以尝试清理 npm 缓存：

   npm cache clean --force
   

4. 重新安装依赖：

   npm install
   

2. 项目启动失败

问题描述：在安装完依赖后，尝试启动项目时可能会遇到启动失败的问题，通常是由于配置文件错误或环境变量设置不当。

解决步骤：

1. 检查配置文件：确保 .env 文件中的环境变量设置正确，特别是 VITE_ 开头的变量。
2. 检查端口占用：如果项目启动时提示端口被占用，可以尝试修改 vite.config.ts 中的端口配置：

   export default defineConfig({
     server: {
       port: 3000, // 修改为你想要的端口
     },
   });
   

3. 重新启动项目：

   npm run dev
   

3. 项目打包失败

问题描述：在项目开发完成后，尝试打包项目时可能会遇到打包失败的问题，通常是由于代码中存在未处理的错误或依赖版本不兼容。

解决步骤：

1. 检查代码错误：确保代码中没有未处理的错误，特别是 TypeScript 类型错误。
2. 更新依赖版本：如果依赖版本不兼容，可以尝试更新依赖版本：

   npm update
   

3. 清理打包缓存：如果之前打包失败，可以尝试清理打包缓存：

   npm run clean
   

4. 重新打包项目：

   npm run build
   

通过以上步骤，新手可以更好地解决在使用 pure-admin-thin 项目时遇到的问题，顺利进行项目开发。