0

0

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

穿越時空

穿越時空

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

|

523人浏览过

|

来源于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}
  • utf8utf8bom 区别很大:utf8 是标准无BOM UTF-8,兼容性最好;utf8bom 开头多3字节,Windows记事本喜欢,但Python/Node.js脚本执行常报 SyntaxError: Non-UTF-8 code starting with '\xff'

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

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

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

  • 真正生效要靠设置项 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存内容,两者错位就出问题。

甲骨文AI协同平台
甲骨文AI协同平台

专门用于甲骨文研究的革命性平台

下载

重点不是调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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

458

2023.08.07

json是什么
json是什么

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

549

2023.08.23

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

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

337

2023.10.13

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

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

84

2025.09.10

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

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

449

2023.07.18

堆和栈区别
堆和栈区别

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

606

2023.08.10

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

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

532

2023.06.20

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

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

596

2023.07.28

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.7万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 8.5万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号