讲师中心 微信公众号
AI工具推荐 视频效率加速

Revel框架模板目录说明:视图文件创建与命名规则

千静姑娘_5425

千静姑娘_5425

发布时间:2026-10-16 11:31:59

|

302人浏览过

|

来源于php中文网

原创

Revel视图文件必须存于app/views/下并严格按控制器名大小写嵌套,文件名与方法名完全一致且小写、.html后缀;多级包需同步路径层级;布局文件仅识别首字母大写的Layout.html。

revel框架模板目录说明:视图文件创建与命名规则 - php中文网

在Revel框架中正确创建和命名视图文件,是确保模板能被控制器精准加载、避免404错误或渲染失败的前提。若命名不遵循约定,即使逻辑完全正确,【Revel将无法自动定位到对应视图】,且不会报错提示具体路径问题,只返回空白页或默认错误页。

视图文件的标准位置与目录结构

Revel强制要求所有视图文件必须存放在 app/views/ 目录下,且需严格按控制器分组嵌套。例如,若控制器为 app/controllers/HomeController.go,其对应视图必须位于 app/views/Home/ 子目录中。

不能把视图文件直接丢进 app/views/ 根目录——Revel会忽略它;也不能擅自改成 app/views/home/(小写),因为控制器类名首字母大写,路径也必须大小写一致。

项目启动后,Revel会扫描 app/views/ 下所有以控制器名命名的子目录,每个子目录即为一个视图命名空间。

视图文件命名规则

视图文件名必须与控制器中的方法名完全一致,且全部小写,后缀为 .html。

例如:控制器中定义了 func (c App) Dashboard() revel.Result,则对应视图文件必须命名为 app/views/App/Dashboard.html。

注意:方法名是 Dashboard,但文件名必须是 Dashboard.html,不是 dashboard.html,也不是 Dashboard.tpl 或 Dashboard.gohtml——Revel只识别 .html 后缀,且区分大小写。

多级控制器路径下的视图定位

当控制器位于子包时,如 app/controllers/admin/UserController.go,其视图路径需同步反映包层级:

Revel框架 0.19.0
Revel框架 0.19.0

Revel框架 0.19.0 版本源码包下载,适合关注 Referrer-Policy、vendor 识别、Gorp 事务抽象和 CSRF 修复的开发团队。

下载

① 控制器全限定名为 admin.UserController,因此视图根目录为 app/views/admin/;

② 方法 UserList() 对应的视图路径是 app/views/admin/User/UserList.html;

③ 若控制器定义在 app/controllers/api/v2/PostController.go,则视图必须放在 app/views/api/v2/Post/ 下,文件名为 Index.html 或 Create.html 等,不可省略 v2 这一层目录。

遗漏任一中间目录层级,Revel在运行时将完全找不到该视图,且日志中仅显示“template not found”,不会指出缺失的是哪一级路径。

嵌套视图与布局复用

Revel支持通过 {{yield}} 实现布局复用,但布局文件本身也需遵守命名约定:

方法一:全局布局文件统一放在 app/views/ 根目录,命名为 Layout.html。所有子视图可通过 {{set .layout "Layout.html"}} 显式指定,或由控制器 c.RenderArgs["layout"] = "Layout.html" 注入。

方法二:局部布局可存于对应控制器视图目录内,例如 app/views/Admin/Layout.html,此时仅 Admin/* 下的视图能直接引用 "Layout.html",无需带路径前缀。

【切勿将布局文件命名为 layout.html 或 LAYOUT.HTML】——Revel对文件名大小写敏感,仅识别首字母大写的 Layout.html 作为默认布局标识符。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
Golang Beego框架
Golang Beego框架

本专题聚焦 Golang 全栈式 Web 框架 Beego 的学习与实战,内容涵盖 MVC 模式、路由控制、ORM 数据库操作、模块化开发、日志管理与 RESTful API 构建。通过企业管理系统、电商后端与微服务架构等实战案例,帮助学员掌握使用 Beego 高效开发企业级应用的核心能力。

3320

2025.08.27

go语言 beego框架
go语言 beego框架

本专题整合了go语言中beego框架相关内容,阅读专题下的文章了解更多详细内容。

6681

2025.09.10

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

0

2026.10.15

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

0

2026.10.15

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

0

2026.10.15

Python 怎么安装并配置环境变量
Python 怎么安装并配置环境变量

Python安装与环境变量配置专题汇集Windows、macOS和Linux的安装步骤、PATH设置、pip配置及常见报错排查文章,帮助完成解释器安装并验证命令行可以正常运行。

0

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Revel 官方入门教程
Revel 官方入门教程

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn