一. 案例背景企业级应用开发中项目结构标准化是保障代码质量和团队协作的关键。本案例以若依RuoYi框架为例展示如何构建符合企业标准的目录结构。通过学习您将掌握目录设计原则、模块划分方法及各类资源的规范组织方式为项目长期发展奠定基础。二. 实验目标三. 前置知识四. 实验环境五. 案例整体流程概况六. 预期成果实验完成后您的系统将具备以下特性若依项目的所有文件集中在/opt/ruoyi目录下结构清晰、职责分明存在一个标准化的application.yml配置文件模板应用启动配置一目了然配置文件通过硬链接在backup目录中留有“防误删副本”删除任一硬链接数据不会丢失仅当所有硬链接都被删除时数据才真正释放日志目录通过软链接统一到/var/log/ruoyi方便系统日志管理工具如logrotate接入日志文件支持按日期压缩归档便于长期保存和磁盘空间管理形成一套完整的操作命令集可直接作为后续自动化脚本的蓝本七. 注意事项⚠️重要提醒硬链接的局限性12.3 节中使用ln创建的硬链接与源文件共享同一份数据同一个 inode。这意味着修改application.yml时application.yml.bak的内容也会同步变化。硬链接只能防止“误删除”无法提供“历史版本回滚”的能力。如果您期望保留修改前的配置版本建议将ln替换为cp复制命令。软链接的权限要求12.4 节中创建软链接/var/log/ruoyi需要 root 权限因为/var/log目录默认只允许 root 写入。如果您当前不是 root 用户请在命令前加sudo。tar 命令中的日期格式12.5 节中正确写法为$(date %F)请勿写成$({date %F}或5{date %F}否则 Shell 无法正确解析命令会执行失败。date %F会生成形如2026-07-18的日期字符串。通配符的潜在问题tar -tzvf /opt/ruoyi/backup/ruoyi-logs-*.tar.gz中的*通配符如果匹配到多个文件tar -f只能接收一个文件会报错。建议先用ls查看具体有哪些备份文件再指定具体文件名进行查看。关于权限设置的补充说明本案例仅涉及目录结构的创建和链接操作未包含chown和chmod的权限设置步骤。若您需要进一步完善权限控制例如将config目录设为750以保护敏感配置请参考前面章节“5.2 实施步骤”中的权限配置方法将权限治理与本案例的目录结构治理相结合。八. 开始实验8.1 创建标准化目录结构步骤1创建若依项目目录图完成后的若依项目标准目录结构示意图步骤2验证目录结构图完成后的若依项目验证目录命令和验证结果示意图步骤3创建配置文件模板图完成后的若依项目例子创建配置命令和文件示意图步骤4硬链接保护配置文件图完成后的若依项目例子硬链接保护配置文件命令示意图步骤5软链接统一日志路径图完成后的若依项目例子软链接命令和查询是否成功和结果示意图步骤6压缩归档日志图完成后的若依项目例子压缩归档日志和查询的命令的示意图九. 小结本文从零开始在 Linux 服务器上为若依项目搭建了一套标准化的目录治理方案核心完成了以下五步使用mkdir -p创建分层目录实现代码、配置、日志、备份的分类存放使用vim创建application.yml配置文件模板统一应用启动配置使用ln创建硬链接保护配置文件防止误删除导致服务中断使用ln -s创建软链接将日志目录统一到/var/log/ruoyi便于系统日志管理使用tar结合$(date %F)变量实现日志的按日期自动归档备份。这套方案本质上是一个“Linux 运维基本功的整合实战”——把mkdir、vim、ln、ln -s、tar这五个最常用的命令串联起来解决了一个真实项目部署中会遇到的目录管理问题。如果你也在部署 Java 项目这套目录结构可以直接复用。下一篇可以聊聊如何配合cron定时任务实现日志的自动清理以及如何用sudo做多角色权限治理欢迎关注。有问题欢迎在评论区留言交流/strong
