Sublime Text汉化后项目文件编码乱码统一教程

胖杰同学_2451

胖杰同学_2451

2026-11-02

720人浏览

原创

汉化本身不会导致乱码,真正原因是编码识别逻辑被干扰;需先用Reopen with Encoding正确识别原始编码(如GBK),再Save with Encoding→UTF-8完成转码,同时禁用detect_encoding、配对设置default_encoding_on_save与fallback_encoding,并通过.sublime-project管理混合编码项目。

sublime text汉化后项目文件编码乱码统一教程

汉化本身不会导致乱码,真正出问题的是编码识别逻辑被干扰——汉化包常附带错误的 default_encoding 或启用 detect_encoding: true,结果让 Sublime 用 GBK 去解 UTF-8 文件,或者跳过 BOM 直接 fallback 到乱码编码。

Reopen with Encoding 是唯一能救回乱码文件的操作

点开一个满屏“锟斤拷”的文件后,右下角显示的 UTF-8 或 Western (ISO 8859-1) 只是当前解码方式,不是文件真实编码。它正在错读,你才看到乱码。

  • 立刻执行 File → Reopen with Encoding → Chinese (GBK)(有时也叫 CP936)
  • 如果还是乱码,再试 Chinese (GB2312);别试 Western (Windows 1252),它根本不含中文字符
  • 只要中文一出来,右下角变成 Chinese (GBK),就说明原始编码识别对了
  • 此时内存里已是正确解码的 Unicode 内容,磁盘文件一字未动

Save with Encoding → UTF-8 才是真正转码动作

前面所有操作都只影响显示,只有这一步才改磁盘文件。跳过 Reopen with Encoding 直接点它,等于把乱码再编码一遍,变成双乱码。

  • 必须在中文显示完全正常后,再执行 File → Save with Encoding → UTF-8(注意:不是 UTF-8 with BOM)
  • 保存后关闭再重开,右下角应显示 UTF-8,且中文依然正常
  • 如果别人用记事本打开还是乱码,说明上一步没做对——文件根本没被正确识别为 GBK
  • 验证是否真去除了 BOM:xxd 文件名 | head -n1,输出不含 ef bb bf 才算干净

用户配置里 fallback_encoding 和 default_encoding_on_save 必须配对设对

ST4(Build 4126+)已彻底移除 fallback_encoding 的实际作用,但很多人还在错误地写它。真正控制行为的是 default_encoding_on_save,而 fallback_encoding 在旧版 ST3 中仍有效,需严格按 Sublime 内置名填写。

Sublime Text Build Linux版
Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载
  • ST4 用户应删掉 fallback_encoding,只保留:"default_encoding_on_save": "UTF-8" 和 "save_with_bom": false
  • ST3 用户推荐配对使用:"default_encoding": "UTF-8" + "fallback_encoding": "Chinese (GBK)"
  • fallback_encoding 不接受标准编码名,写 "UTF-8" 是无效配置;必须用 "Chinese (GBK)"(括号、空格、大小写全敏感)
  • 务必删掉配置里的 detect_encoding: true——它会让 Sublime 主动跳过 BOM 去试 GBK,把带 BOM 的 UTF-8 文件判成乱码

混合编码项目不能靠全局设置,得用 .sublime-project 绑定规则

同一目录下既有 UTF-8 脚本又有 GBK 配置文件时,全局 fallback_encoding 或插件自动转换会互相打架。Git 提交失败、Python 报 Non-UTF-8 code starting with '\xef',往往就是这个原因。

  • 右键项目根目录 → Open Folder as Project → Project → Save Project As… 生成 .sublime-project
  • 在该文件中添加编码规则,例如:
{
  "folders":
  [
    {
      "path": "."
    }
  ],
  "settings":
  {
    "default_encoding_on_save": "UTF-8",
    "save_with_bom": false
  },
  "file_exclude_patterns": ["*.log"],
  "syntax_override": {
    "config/*.ini": "Packages/INI/INI.sublime-syntax",
    "legacy/*.conf": "Packages/Text/Plain text.sublime-syntax"
  }
}

更关键的是:对 GBK 类型文件(如 *.ini),可在 View → Encoding 手动切到 Chinese (GBK) 后再编辑,避免误存为 UTF-8。

最易被忽略的一点:汉化包自带的设置常覆盖你手动改的编码项,装完汉化后务必检查 Preferences → Settings – User 是否被注入了错误的 default_encoding 或 detect_encoding。删掉它们,再按需重配。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

20

17

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

2026.11.02

20

17

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

120

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

100

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

300

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程