讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode怎么设置文件保存编码为UTF-8_VSCode如何修改默认文件保存字符编码【教程】

落敏酱_3167

落敏酱_3167

发布时间:2026-03-18 20:05:31

|

763人浏览过

|

来源于php中文网

原创

VSCode保存文件时编码变成GBK或ISO-8859-1的根本解法是设files.encoding为utf8且files.autoGuessEncoding为false,禁用自动猜测并强制UTF-8(无BOM);项目混有GBK文件时应使用工作区设置而非全局设置。

vscode怎么设置文件保存编码为utf-8_vscode如何修改默认文件保存字符编码【教程】

VSCode保存文件时编码变成GBK或ISO-8859-1

VSCode默认会根据文件已有内容“猜”编码,如果文件开头没BOM、又含中文但历史用过GBK打开过,它就可能沿用GBK保存——下次你改完一保存,git diff里全是乱码,同事拉代码直接报错。

根本解法不是每次手动转编码,而是让VSCode**默认新建+保存都走UTF-8(无BOM)**。操作路径:设置 → 搜索 files.encoding → 改成 utf8(注意不是 utf8bom)。

  • 必须关掉 files.autoGuessEncoding:设为 false,否则它仍会偷偷读取旧文件头“推测”,覆盖你的默认设置
  • 如果项目里混着GBK遗留文件,别全局强制,改用工作区设置——在项目根目录建 .vscode/settings.json,只写这两行:
    {"files.encoding": "utf8","files.autoGuessEncoding": false}
  • utf8 和 utf8bom 区别很大:utf8 是标准无BOM UTF-8,兼容性最好;utf8bom 开头多3字节,Windows记事本喜欢,但Python/Node.js脚本执行常报 SyntaxError: Non-UTF-8 code starting with '\xff'

保存后文件实际编码还是不对?检查编辑器右下角状态栏

VSCode右下角总显示当前文件编码(比如 UTF-8 或 GBK),点它能快速重载或另存为指定编码——但这只是“当前文件”的临时操作,不改变默认行为。

常见误操作:点了右下角 → Save with Encoding → 选了 UTF-8,以为搞定。其实这只是救急,下次新建文件或别人打开同一文件,照样掉坑。

VSCode
VSCode

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

下载
  • 真正生效要靠设置项 files.encoding,不是状态栏点击
  • 如果点状态栏后显示 UTF-8 with BOM,说明文件已被写入BOM,此时再改设置也晚了——得先用“Reopen with Encoding”选 UTF-8,再手动删BOM(Ctrl+A → Backspace → Ctrl+Z撤销选中,再保存)
  • 某些插件(如“Auto Rename Tag”)会触发自动保存,如果此时编码没设对,它就默默用错编码存档,很难排查

Git提交时中文变问号或乱码

这通常不是VSCode的问题,而是Git自身对路径和内容编码的处理逻辑导致的。Windows Git默认用系统编码(GBK)处理文件名,而VSCode用UTF-8存内容,两者错位就出问题。

重点不是调VSCode,而是告诉Git:“所有路径和内容,一律当UTF-8处理”。运行命令:

git config --global core.quotepath false<br>git config --global core.precomposeunicode true
  • core.quotepath false 让git log里中文路径正常显示,不转义成 "\344\270\255\346\226\207"
  • core.precomposeunicode true 仅对macOS必要;Windows用户可忽略,但加了也无害
  • 如果已出现乱码提交,git status 显示一堆带 \200\300 的文件名,说明Git内部已按GBK解析过路径——此时需重置索引:git rm -r --cached . && git add .

终端里用code命令打开文件,编码又不对

通过终端运行 code xxx.py 打开文件时,VSCode有时会忽略工作区设置,退回到全局编码规则。尤其当该文件之前被其他编辑器用非UTF-8打开过,VSCode缓存了它的“编码偏好”。

  • 最稳方案:打开VSCode后,用图形界面菜单 File → Open Folder 打开整个项目,确保加载了 .vscode/settings.json
  • 临时补救:打开文件后,右下角点编码 → Reopen with Encoding → 选 UTF-8,再立刻点一次 → Save with Encoding → 选 UTF-8(顺序不能反,否则BOM残留)
  • 避免未来踩坑:在用户设置里加一句 "files.defaultLanguageForEmptyFiles": "plaintext",防止新建空文件时因语言模式缺失导致编码判断失灵

编码问题从来不是单点配置能彻底解决的,它横跨编辑器、Git、终端、甚至文件系统缓存。最常被忽略的是:你以为改了设置就一劳永逸,其实VSCode会记住每个文件的“历史编码偏好”,这个缓存藏在 %APPDATA%\Code\Cache(Windows)或 ~/Library/Caches/com.microsoft.VSCode.ShipIt(macOS)里,删掉才真正清零。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2275

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3662

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1216

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4239

2025.09.10

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

6647

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2748

2023.08.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4816

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1415

2023.07.28

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn