新建JSP文件编码不生效需先设项目默认编码为UTF-8并勾选Override encoding;pageEncoding决定文件读取编码,contentType决定响应头声明,二者须统一为UTF-8;模板、文件、Tomcat配置及work目录均需同步更新。

新建 JSP 文件时编码不生效?先改项目默认编码再建文件
直接新建 JSP 文件却仍是 GBK 或 ISO-8859-1,大概率是因为项目级编码没设对。Eclipse 不会自动继承工作空间编码到每个文件,尤其 Web 项目常沿用老项目默认值。
- 右键项目 → Properties → Resource → 把
Text file encoding改成UTF-8 - 务必勾选
Override encoding from container(否则可能被服务器容器如 Tomcat 覆盖) - 改完后,必须重新新建 JSP 文件——已存在的 JSP 不会自动重编码,需手动右键 → Properties → Resource → 单独设编码并保存
page 指令里 contentType 和 pageEncoding 到底谁管什么?
pageEncoding 决定 JSP 文件本身以什么字符集读取(即磁盘上怎么解码),contentType 决定响应头 Content-Type 发给浏览器的声明(含 charset)。两者不一致会导致乱码,且优先级不同。
- 推荐统一设为 UTF-8:
- 如果只设
contentType而没设pageEncoding,Eclipse 可能按项目编码读文件,但浏览器按响应头解码,中间错位就乱码 - JSP 编译成 Servlet 后,
pageEncoding影响的是生成的 Java 源码字符串字面量编码,这点容易被忽略
用 Eclipse 自带 JSP 模板创建文件,为什么开头没 page 指令或写法老旧?
Eclipse 自带的 JSP 模板(如 New → JSP File)默认使用老版本模板,可能缺 pageEncoding、用 ISO-8859-1、甚至带过时的 isELIgnored="false"。
- 进 Window → Preferences → Web → JSP Files → Templates,编辑默认模板,把首行替换成:
- 模板中避免硬编码
http-equiv="Content-Type"meta 标签——它仅影响浏览器解析,不替代响应头,且可能和contentType冲突 - 若团队共用,建议导出模板(Export)并共享
.epf文件,避免每人重复配置
保存后浏览器仍乱码?检查三个地方是否全部对齐
即使 JSP 文件、page 指令、模板都设了 UTF-8,乱码还可能来自外部环节。Eclipse 本身不控制运行时行为,关键链路要逐个确认。
- Tomcat 的
conf/server.xml中Connector是否加了URIEncoding="UTF-8"(处理 GET 参数) - JSP 中中文静态文本是否真以 UTF-8 存盘(用 Notepad++ 或 VS Code 查看文件实际编码,别只信 Eclipse 右下角显示)
- 浏览器开发者工具 Network 标签页里,响应头
Content-Type值是否真包含charset=UTF-8;若显示charset=ISO-8859-1,说明某处覆盖了设置
最易漏的是:改完 pageEncoding 后没清空 Tomcat 工作目录(work/Catalina/localhost/yourapp/),旧编译结果还在用老编码读取。删掉整个 work 目录再重启,才真正生效。










