每次打开日志文件看到一堆莫名其妙的“��”符号，是不是让你忍不住想把键盘砸了？别慌，这篇文章会一步步带你找出根源、 差点意思。 调平编码，让你的日志重新变得清晰可读，工作效率瞬间飙升。

一、 乱码的幕后黑手——编码不匹配

在JVM启动时会默认使用系统的字符集，而Tomcat的日志框架往往采用ISO-8859-1或GBK。 搞一下... 如果两者不统一，就会出现常见的中文显示为乱码的尴尬局面。

下面这段代码可以帮助你快速检查当前JVM使用的编码：

System.out.println);

如果输出不是UTF-8那就说明我们要动手改动了。

二、 最靠谱的三招：从根本上统一编码

1️⃣ 修改Tomcat启动脚本，强制使用UTF‑8

在$CATALINA_HOME/bin/setenv.sh或%CATALINA_HOME%\\bin\\setenv.bat中加入如下语句：，深得我心。

# Linux/Mac
export J娱乐A_OPTS="$J娱乐A_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8"
# Windows
set J娱乐A_OPTS=%J娱乐A_OPTS% -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8

保存后重启Tomcat，所有通过JVM写 扯后腿。 入的文本都会走UTF‑8这条“高速公路”。

2️⃣ 在server.xml里配置Connector的URIEncoding

往白了说... 如果你的请求参数里也出现乱码，那就一定是Connector没有正确解码。打开$CATALINA_HOME/conf/server.xml找到对应的节点：

我个人认为... 这一步保证了URL中的中文也能被正确解析并写入日志。

3️⃣ 调整日志框架本身的编码

a) Log4j 2.x 示例：

    
        
            
                %d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger{36} - %msg%n
            
        
    
    
        
            
        
    

b) Logback 示例：

    
        ${catalina.base}/logs/app.log
        
            %d{yyyy-MM-dd HH:mm:ss.SSS}  %-5level %logger - %msg%n
        
    
    
        
              

记得修改完后一定要重启Tomcat，否则新配置永远不会生效。

三、 系统层面的调优——让操作系统说话也用UTF‑8

# ~/.bashrc 或 ~/.zshrc
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
source ~/.bashrc   # 马上生效

$env:LANG = "en-US"
$env:LC_ALL = "en-US"
# 重启 PowerShell 窗口

是不是？ 有时候即使Tomcat内部已经设置好了UTF‑8，如果底层系统仍然返回GBK，日志仍然会出现碎片化字符。做好这一步，你就彻底摆脱了“乱码”魔咒。

四、 别忘了检查IDE与控制台的一致性 🎉

If you run Tomcat from IntelliJ IDEA or Eclipse, make sure console encoding matches UTF‑8:，探探路。

Eclipse: Preferences → General → Workspace → Text file encoding → UTF‑8. IDEA: Settings → Editor → File Encodings → Global Encoding → UTF‑8. If you still see garbled text in IDE console, try adding -Dconsole.encoding=UTF-8. \endul，一阵见血。

五、排查小技巧——逐项验证法则🔎

1. Simplify：先只打印一行纯中文信息。
2. Curl：用curl直接访问应用接口，看返回体是否正常。
3. Tailing：使用tail -f catalina.out | iconv -f ISO-8859-1 -t UTF-8, 检查实时流是否被转码。
4. If all good, n gradually恢复其它日志组件配置。
\endol

六、 收官感言——从痛点到畅快，一键搞定！ 🚀

Aha！当你看到终端里清晰可辨的中文日志时那种成就感简直比吃到一碗热气腾腾的牛肉面还爽。别再主要原因是乱码抓狂，也不要把时间浪费在无休止的搜索和试错上。 换言之... 只要按本文提供的“三步走+系统调优+IDE对齐”， 几分钟即可让Tomcat告别乱码，从此专注业务代码，效率自然飞涨。

注意