如何解决Github与Visual Studio因字符集差异导致的乱码问题
2026-5-20
解决Visual Studio强制EUC-KR编码导致Github注释乱码的问题
这确实是个让人头疼的矛盾——既要满足VS的编码要求避免崩溃，又得让跨平台的学生能正常查看注释，我来分享几个经过验证的实用方案：
方案1：给代码文件加编码声明，让Github自动识别
Github会优先读取文件内的编码声明来解析内容，你可以在每个代码文件的最开头添加一行注释指定编码：
- 对于C/C++/C#这类语言：
// -*- coding: euc-kr -*- - 对于Java类文件：
/* -*- coding: euc-kr -*- */
这样Github就能正确用EUC-KR编码渲染注释，Mac/Linux用户查看时就不会出现乱码，同时VS依然能正常处理文件。
方案2：修复VS切换UTF-8时崩溃的问题，彻底统一编码
VS切换编码崩溃大概率不是编码本身的问题，可能是项目缓存或特殊字符导致的，你可以按以下步骤尝试：
- 先完整备份整个项目，避免操作失误丢失代码
- 关闭VS，删除项目目录下的
bin、obj文件夹（这些是编译缓存文件） - 重新打开项目，选中所有代码文件，右键选择「高级保存选项」，将编码设置为「UTF-8 带签名」
- 保存后清理解决方案，再重新编译
如果还是崩溃，检查注释里是否包含全角符号、不可见控制字符（比如异常换行符），移除这些特殊内容后再尝试切换编码。
方案3：用.gitattributes强制Github识别编码
在仓库根目录创建.gitattributes文件，添加对应文件类型的编码规则，比如你的项目是C#的话：
*.cs text encoding=EUC-KR *.txt text encoding=EUC-KR
这个文件会告诉Git和Github，指定后缀的文件使用EUC-KR编码解析，无需依赖用户的系统默认编码，跨平台查看时就能正常显示注释了。
建议先从方案1或3开始尝试，操作简单且不会影响VS的正常使用；如果想彻底统一为UTF-8，再尝试方案2解决VS崩溃的问题。
内容的提问来源于stack exchange，提问作者user3867261
