Eclipse创建JSP页面设置与技巧

本文深入解析了在Eclipse中创建和配置JSP页面时避免中文乱码的核心要点：必须同步统一项目默认编码（UTF-8并勾选Override）、JSP文件的pageEncoding与contentType、模板设置、Tomcat服务器配置（如URIEncoding）以及work目录清理等关键环节，任何一环疏漏都可能导致乱码；文章不仅指出常见误区（如误信Eclipse编码显示、忽略编译缓存），还提供了从新建文件到运行验证的完整排查链路，帮助开发者一次性彻底解决JSP编码顽疾。

新建 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：<%@ page pageEncoding="UTF-8" contentType="text/html;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，编辑默认模板，把首行替换成：<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
• 模板中避免硬编码 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 目录再重启，才真正生效。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Eclipse创建JSP页面设置与技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。