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

VSCode怎么解决新建文件中文无法显示

阿晨君_9329

阿晨君_9329

发布时间:2026-10-17 10:42:30

|

964人浏览过

|

来源于php中文网

原创

新建文件中文乱码根本原因是编码链断裂:VS Code默认UTF-8创建文件,但Windows系统工具(如记事本、bat/reg文件)依赖GBK,导致输入中文后底层字节被错误解析;应禁用自动猜测、按后缀精准关联编码(如*.txt→gbk),而非全局设utf8。

vscode怎么解决新建文件中文无法显示

新建文件中文无法显示,根本不是文件“坏了”,而是 VSCode 默认用 UTF-8 创建文件,但你的系统或终端根本没准备好接 UTF-8 —— 尤其在 Windows 上,新建的 .txt、.ini、.bat 文件一写中文就变“涓枃”,十有八九是编码链断裂了。

新建文件一输中文就乱码?先看右下角状态栏是不是“UTF-8”

如果状态栏显示 UTF-8,但你刚按 Ctrl+N 新建一个空白文件,输入“测试”立刻变成方块或“娴嬭瘯”,说明问题不在文件本身,而在 VSCode 创建新文件时的默认行为与系统环境不匹配:

  • Windows 默认记事本、注册表编辑器、老软件生成的 INI/REG 文件,几乎全用 GBK(即 CP936)编码;VSCode 却坚持用 UTF-8 创建新文件,导致你敲的每个中文,在底层被当成 UTF-8 字节写入,而系统工具读它时仍按 GBK 解,必然错位
  • 点右下角 UTF-8 → 选 Save with Encoding → GBK,只是把当前文件覆写成 GBK,但下次 Ctrl+N 还是会新建 UTF-8 文件,治标不治本
  • 真正要改的是新建逻辑:不是“让文件变 GBK”,而是“让新建动作默认用 GBK”——但这不能全局硬设,否则 Python 脚本保存后带 BOM 会报 SyntaxError: Non-UTF-8 code starting with '\xff'

settings.json 里加 "files.encoding": "utf8" 为什么反而更乱?

因为大小写和作用域都错了:

VSCode
VSCode

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

下载
  • "utf8" 必须全小写;写成 "UTF-8"、"UTF8" 或 "utf-8",VSCode 直接忽略该配置,你以为设了,其实没生效
  • 如果在用户级 settings.json(全局)加这行,所有新文件、所有语言、所有后缀都会强制 UTF-8 —— 看似统一,实则让 .bat 执行失败、.reg 双击导入出错、Git 提交日志出现 \u4f60\u597d
  • 正确做法是分层控制:对新建文件本身,不改默认编码,而是关掉自动猜测 + 显式声明常见中文后缀的关联编码,例如在工作区根目录的 .vscode/settings.json 中写:
"files.associations": {
  "*.txt": "gbk",
  "*.ini": "gbk",
  "*.reg": "gbk",
  "*.bat": "gbk"
},
"files.autoGuessEncoding": false

这样,你双击打开一个老 config.ini,或新建一个 readme.txt,VSCode 都会按 GBK 处理;但 .py、.js 仍走默认 UTF-8,互不干扰。

终端输出中文正常,但新建文件里输中文还是乱?检查字体和系统 locale

这是常被忽略的底层依赖:

  • VSCode 编辑器界面能显示中文 ≠ 编辑器内能正常渲染中文字符。如果新建文件里中文显示为方块、空心框或问号,大概率是 editor.fontFamily 没包含中文字体,比如只写了 'Fira Code',没 fallback 到 'Noto Sans CJK SC' 或 'Microsoft YaHei'
  • Linux/macOS 用户还需确认系统 locale 是否启用 UTF-8:终端执行 locale,输出中 LANG 和 LC_ALL 应含 zh_CN.UTF-8 或 en_US.UTF-8;若为 C 或 POSIX,VSCode 字体回退机制可能失效
  • Windows 用户注意:chcp 65001 只影响终端,不影响编辑器内新建文件的编码行为;别指望改终端就能让新建文本文件输中文不乱

最易被忽略的一点:新建文件的编码行为,由 files.encoding(创建时用什么编码)、files.autoGuessEncoding(是否尝试猜)、files.associations(后缀优先级)三者共同决定,缺一不可。任意一层配错,都可能让“新建→输中文→乱码”这个循环反复发生。

热门AI工具

更多
豆包大模型

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

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

相关专题

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

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

1355

2023.06.30

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

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

2872

2023.07.21

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

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

1969

2024.03.14

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

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

1727

2024.03.14

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

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

2607

2024.03.15

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

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

1838

2024.03.15

vscode用途介绍
vscode用途介绍

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

1262

2024.03.15

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

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

1116

2024.03.15

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

0

2026.10.16

热门下载

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

精品课程

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

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