Express中res.render加ejs后缀和不加后缀哪种写法更准确？

核心设计逻辑 #

当你通过app.set('view engine', 'ejs')配置了默认模板引擎后，Express的视图查找会遵循以下规则：

• 若调用res.render时传入的视图名不带文件后缀，Express会自动追加你配置的默认后缀（这里是.ejs），再到views目录下查找对应文件
• 若传入的视图名带文件后缀，Express会直接使用你传入的完整文件名查找，不会额外追加默认后缀

你测试的三个结果完全匹配上述规则：

• 调用res.render('test')：自动追加.ejs，查找test.ejs，因此渲染该文件
• 调用res.render('test.ejs')：直接按传入的文件名查找test.ejs，因此渲染该文件
• 调用res.render('test.ejs.ejs')：直接按传入的文件名查找test.ejs.ejs，因此渲染该文件

常见疑问解答 #

为什么官方文档和主流写法都不带后缀？ #

核心原因有两个：

• 可维护性更高：如果后续需要更换项目的模板引擎（比如从EJS换成Nunjucks），你只需要修改view engine的配置项即可，不需要逐行修改所有路由中res.render的后缀
• 写法更简洁统一：符合Express官方的设计约定，所有使用默认模板引擎的渲染逻辑都不需要额外标注后缀，代码更简洁，也便于团队协作时统一规范

两种写法有没有本质区别？ #

常规开发场景下没有功能差异，仅在两类特殊场景下有区别：

• 项目中存在xxx.ejs、xxx.ejs.ejs这类多重同名后缀的极端文件结构时，带后缀的写法可以精准指定要渲染的文件
• 项目配置了多模板引擎共存时，带后缀的写法可以跳过默认模板引擎，直接指定用对应后缀的模板引擎渲染文件（比如同时配置EJS和Pug时，写res.render('test.pug')就会直接调用Pug引擎渲染，不管默认引擎是不是EJS）

补全后缀的写法是不是更准确？ #

常规开发场景下完全没有必要，反而会降低代码的可维护性。你说的“更准确”仅适用于上述提到的极端特殊场景，而正常项目开发几乎不会出现多重同名后缀的文件命名，补全后缀的写法属于冗余操作，也不符合社区通用约定。

内容的提问来源于stack exchange，提问作者Mohammed Saeid