texstudio中文不显示主因是文件编码与编辑器设置不匹配:gbk文件需设默认编码为gbk,utf-8文件应设为utf-8并勾选自动检测;新项目推荐全局启用utf-8保存并使用xelatex编译。

TeXstudio中文不显示,最常见的情况是打开一个GBK编码的旧论文模板时满屏乱码,或者新建文档输入“你好”后编译出空白、问号甚至报错。这根本不是LaTeX写错了,而是编辑器和文件用的“密码本”对不上号。
确认并修正.tex文件的实际编码
先别急着改设置,用记事本或VS Code打开你的.tex文件,另存为时看右下角显示的编码格式——如果显示“ANSI”或“GBK”,那它大概率就是GBK编码;如果显示“UTF-8”,那就不是编码问题,跳过这节。
方法一:文件是GBK编码,但TeXstudio误用UTF-8打开 → 打开选项 → 配置TeXstudio → 编辑器,在“默认编码”下拉菜单中【选择GBK】,点击确定。此时关闭并重新打开该文件,中文立即正常显示。
方法二:文件是UTF-8编码(带BOM或无BOM),但TeXstudio识别成其他编码 → 同样进入“配置TeXstudio → 编辑器”,将“默认编码”设为【UTF-8】,同时勾选“自动检测编码”。这一步能覆盖绝大多数新项目场景。
重要提醒:千万别在TeXstudio里直接用“文件 → 另存为 → 编码选择”去转换GBK文件为UTF-8。它会破坏汉字字节序列,导致不可逆乱码。必须用专用工具(如Notepad++)转码,或重写内容。
强制TeXstudio全局使用UTF-8(推荐新项目)
如果你从零开始写中文论文或报告,务必让整个工作流统一用UTF-8,这是现代LaTeX生态的标准做法。
第一步:打开选项 → 配置TeXstudio → 编辑器,把“默认编码”设为UTF-8;
第二步:滚动到底部,找到“文件载入/保存”区域,勾选“始终以UTF-8保存文件”;
第三步:点击右下角状态栏当前编码显示(如“UTF-8”或“GBK”),手动切换为UTF-8;
第四步:新建一个空白.tex文件,输入\documentclass{ctexart}\begin{document}你好\end{document},保存。此时文件物理编码、编辑器识别编码、LaTeX宏包三者完全对齐。
检查并切换XeLaTeX编译器
即使编码全对,用pdfLaTeX编译也会失败——它根本不认识UTF-8里的汉字字节。
打开选项 → 配置TeXstudio → 构建,在“默认编译器”下拉菜单中【选择XeLaTeX】;
回到主界面,点击左上角“工具 → 编译”或按快捷键F5,观察底部日志是否出现XeTeX字样;
若仍报错“Font \zf@basefont=SimSun/m/n/10 not loadable”,说明系统缺字体,临时改用\usepackage{ctex}替代手动设字体,它会自动 fallback 到可用中文字体。











