ejs文件在vs code中默认无法格式化,因prettier不原生支持.ejs后缀,必须配置prettier.documentselectors: ["**/*.ejs"]并安装vscode-ejs-language-service插件,二者缺一不可。

EJS 文件在 VS Code 中默认无法被格式化,装了 Prettier 也不起作用——根本原因是它没被识别为可格式化语言,Prettier 根本不“知道”该处理 .ejs 后缀。
为什么 prettier.documentSelectors 是关键配置项
VS Code 的 Prettier 插件默认只监听 .js、.html、.css 等内置支持的后缀;.ejs 不在白名单里,哪怕你装了插件、写了 .prettierrc,按 Shift+Alt+F 或保存时都静默失败。
- 必须显式告诉 Prettier:“
.ejs文件也归你管”,靠的就是prettier.documentSelectors配置 - 值要写成
["**/*.ejs"](注意是双星号通配,不是"*.ejs"或"files.associations") - 这个配置只在
settings.json里生效,UI 设置面板搜不到它,必须手动加 - 如果工作区有
.vscode/settings.json,优先级高于全局设置,记得检查是否被覆盖
必须搭配 vscode-ejs-language-service 插件
光配 prettier.documentSelectors 还不够:Prettier 需要语言服务提供 AST 解析能力,而原生 Prettier 不支持 EJS。这个插件就是桥接层。
- 只认准作者
DigitalBrainstem的vscode-ejs-language-service,其他名字带 “EJS” 的大多只做高亮 - 安装后必须执行
Developer: Reload Window(Ctrl+Shift+P输入),否则右下角语言模式不会出现EJS选项 - 点击右下角语言模式,手动选
EJS;若没这个选项,说明插件未加载或缓存异常 - 该插件同时启用 Emmet 补全(如输入
div.container+ Tab),但需额外配"emmet.includeLanguages": {"ejs": "html"}
别碰 eslint.validate 和 html.format.* 相关设置
这两类配置对 EJS 不仅无效,还会引发冲突或误格式化。
- 删掉所有含
"eslint.validate": ["ejs"]或"eslint.options": {"extensions": [".ejs"]}的配置——ESLint 无法解析混合语法,报的全是Unexpected token ' - 禁用
html.format.templating(已废弃)、html.format.enable等 HTML 格式化开关——VS Code 内置 HTML 格式化器会把当标签缩进,破坏逻辑结构 - 不要给
.ejs文件配editor.defaultFormatter为vscode.html-language-features,它和 EJS 插件抢控制权 - 如果用了
prettier-plugin-html或类似插件,确保它没覆盖 EJS 的解析逻辑
格式化行为本身有明确边界
即使配置全对,EJS 格式化也做不到像 JS 或 HTML 那样“干净利落”。它的能力取决于模板结构的规整程度。
- 简单块如
、能正确缩进;但嵌套过深(如{ %> { %>)大概率跳过 - 非标准写法如
、可能不被识别,导致换行错位 - 格式化不会重排 JS 表达式内部(比如
不会自动折行),只调整块与 HTML 标签之间的缩进层级 - 真正卡住的时候,90% 是
prettier.documentSelectors拼错了路径,或插件没重载——先查这两处,比重装十次插件更省时间











