VSCode解决乱码问题:GBK与UTF-8编码转换设置教程

大强吖_9988

大强吖_9988

2026-04-24

969人浏览

原创

先点“Reopen with Encoding”确认真实编码,再点“Save with Encoding”真正转码;前者仅改变读取方式不修改文件,后者才重写磁盘内容为指定编码。

vscode解决乱码问题:gbk与utf-8编码转换设置教程

VSCode 里中文乱码,不是文件坏了,而是它读错了字节——点右下角编码名,选“Reopen with Encoding”试 GBK 或 UTF-8,能正常显示再点“Save with Encoding”存成 UTF-8,这才是真转换。

右下角点击后选“Reopen with Encoding”还是“Save with Encoding”?

这两个操作完全不是一回事,混用会白忙活:

  • Reopen with Encoding:只改当前 VSCode 怎么读这个文件,不碰磁盘内容。适合排查——比如打开一个乱码 .txt,点它 → 选 GBK,文字出来了,说明原文件就是 GBK 编码
  • Save with Encoding:把编辑器里现在看到的内容,按你选的编码(如 UTF-8)重新写进硬盘。这才是真正“转码”,文件字节变了
  • 常见错误:乱码时直接点右下角 → 选 UTF-8(没选“Reopen”),结果满屏方块——那是 VSCode 强行用 UTF-8 解释 GBK 字节,不是切换,是错解
  • 如果点完没反应,先按 Ctrl+S 保存一下再试,VSCode 有时要求文件有修改才激活菜单项

为什么改了 files.encoding 还是乱码?

因为 files.encoding 只管新建文件和没 BOM 的旧文件,对已有文件几乎没用:

  • 设置 "files.encoding": "utf8" 后,新建的 .js、.txt 默认是 UTF-8,但昨天打开过的 GBK 文件,VSCode 会记住上次用的编码,下次仍按 GBK 打开
  • 想让已有文件也“听话”,得关掉自动猜测:"files.autoGuessEncoding": false——否则它可能在你不知情时又切回 GBK
  • 如果某个文件死活记不住你选的 UTF-8,删掉工作区下的 .vscode/workspaceStorage 文件夹,重启 VSCode,它就清空记忆重来

批量转 GBK 到 UTF-8 别靠 VSCode 插件

VSCode 没有真正批量转码能力,所谓“一键转所有”插件,本质是循环执行“Reopen + Save”,一旦中间某个文件识别失败,就静默损坏:

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • Windows 用户推荐 PowerShell + iconv:Get-ChildItem *.js | ForEach-Object { iconv -f GBK -t UTF-8 $_.FullName | Set-Content "$($_.DirectoryName)\$($_.BaseName)_utf8$($_.Extension)" -Encoding UTF8 }
  • macOS/Linux 直接用:find . -name "*.txt" -exec iconv -f GBK -t UTF-8 {} -o {}.utf8 \;
  • 转之前先确认真实编码,别瞎猜:file -i *.txt 或 enca -L zh filename,混合编码项目尤其要扫一遍再分批处理
  • 带 BOM 的 UTF-8 文件,VSCode 通常能识别;但 GBK 无 BOM 的旧文件,autoGuessEncoding 基本靠不住,手动干预更稳

终端输出中文乱码跟编辑器编码设置无关

编辑器里中文正常、终端里 python script.py 输出乱码,这不是 VSCode 设置问题,是 shell 进程自己的编码没配好:

  • PowerShell:必须在 $PROFILE 里加 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8,且确认用的是 $PROFILE.CurrentUserCurrentHost 路径(默认不存在,要手动创建)
  • Git Bash:检查 ~/.bashrc 有没有 export LANG=zh_CN.GBK,删掉或改成 en_US.UTF-8
  • cmd:加启动参数 /K chcp 65001 >nul,或换 Windows Terminal 并设 "unicode": true
  • Python 报 UnicodeEncodeError: 'gbk' codec can't encode,说明 sys.stdout.encoding 是 GBK,改代码加 reconfigure 是临时补丁,根子在终端

最麻烦的永远是混合编码:有的 .js 是 UTF-8,有的 .log 是 GBK,还有几个 ANSI 的旧配置。这时候盯着 VSCode 右下角点来点去,不如先用命令行扫清底数,再分类动手——编码这事,宁可慢一点,别信“全自动”。

相关文章

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

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

下载

相关标签:

vscode

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

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1575

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

3412

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

2129

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1767

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2627

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1858

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1302

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1156

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

554

5

热门下载

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

精品课程

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