RuoYi-Vue-Plus/PowerShell中文乱码解决方案.md

PowerShell中文乱码解决方案

问题描述

在Windows系统中启动RuoYi-Vue-Plus项目时，控制台输出的中文日志可能出现乱码问题，表现为：

• Sa-Token等框架组件的中文提示显示为乱码
• 部分应用日志中文字符显示异常
• 控制台输出编码不统一

产生原因

1. JVM默认字符编码问题：JVM启动时没有指定正确的字符编码
2. PowerShell控制台编码问题：PowerShell默认编码与应用输出编码不一致
3. 系统语言设置问题：系统区域设置与应用期望的编码不匹配

解决方案

方案一：使用优化的启动脚本（推荐）

1. 使用提供的启动脚本：

   .\start-dev-utf8.ps1
   

2. 脚本主要优化内容：

   • 设置PowerShell控制台UTF-8编码
   • 配置JVM字符编码参数
   • 设置系统语言和时区
   • 优化内存和GC参数

方案二：手动设置JVM参数

在启动应用时添加以下JVM参数：

-Dfile.encoding=UTF-8 
-Dconsole.encoding=UTF-8 
-Duser.language=zh 
-Duser.country=CN 
-Duser.timezone=Asia/Shanghai

Maven启动示例：

$env:MAVEN_OPTS = "-Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8 -Duser.language=zh -Duser.country=CN"
mvn spring-boot:run -pl ruoyi-admin -Dspring-boot.run.profiles=dev

直接Java启动示例：

java -Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8 -Duser.language=zh -Duser.country=CN -jar ruoyi-admin.jar

方案三：IntelliJ IDEA配置

1. 设置Run Configuration JVM参数：

   • 打开 Run/Debug Configurations
   • 在 VM options 中添加：

     -Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8 -Duser.language=zh -Duser.country=CN -Duser.timezone=Asia/Shanghai
     

2. 全局IDEA设置：

   • 打开 Help -> Edit Custom VM Options
   • 添加以下参数：

     -Dfile.encoding=UTF-8
     -Dconsole.encoding=UTF-8
     

3. 项目编码设置：

   • File -> Settings -> Editor -> File Encodings
   • 设置所有编码为 UTF-8

方案四：系统级解决方案

1. Windows系统设置：

   • 打开 控制面板 -> 区域 -> 管理 -> 更改系统区域设置
   • 勾选 Beta版：使用Unicode UTF-8提供全球语言支持
   • 重启系统

2. PowerShell配置文件设置：

   # 在PowerShell配置文件中添加以下内容
   [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
   $OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding
   

验证解决方案

启动应用后，观察以下内容应正确显示中文：

1. PMS模块初始化信息：

   ===============================================
   ========== PMS民宿管理模块初始化完成 ==========
   ========== 包名: org.dromara.pms        ==========
   ========== 版本: 1.0.0              ==========
   ===============================================
   

2. Sa-Token认证提示：

   请求地址'/pms/test/database',认证失败'未能读取到有效token',无法访问系统资源
   

3. 其他框架组件的中文提示应正常显示

常见问题

Q1: 脚本执行策略限制

问题：PowerShell提示无法执行脚本 解决：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q2: 部分字符仍然乱码

问题：某些特定组件的中文仍有乱码 解决：

1. 检查日志框架配置文件编码
2. 确认相关jar包内部编码设置
3. 添加更多JVM编码参数：

   -Djava.awt.headless=true
   -Dsun.jnu.encoding=UTF-8
   -Djava.io.tmpdir.encoding=UTF-8
   

Q3: IDEA控制台乱码

问题：在IDEA中运行仍有乱码 解决：

1. Help -> Edit Custom VM Options 添加编码参数
2. Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Runner 设置VM Options
3. 重启IDEA

最佳实践建议

1. 统一使用UTF-8编码：项目、IDE、系统均设置为UTF-8
2. 使用提供的启动脚本：避免每次手动设置参数
3. 团队开发规范：建立统一的开发环境配置文档
4. 持续验证：定期检查新加入的组件是否支持UTF-8

参数说明

参数	说明	作用
-Dfile.encoding=UTF-8	设置文件默认编码	影响文件读写编码
-Dconsole.encoding=UTF-8	设置控制台编码	影响控制台输出编码
-Duser.language=zh	设置用户语言	影响本地化消息显示
-Duser.country=CN	设置用户国家	影响地区特定格式
-Duser.timezone=Asia/Shanghai	设置时区	统一时间显示格式

使用这些解决方案后，中文乱码问题应该得到完全解决。