VS Community 2019合并分支报错Illegal characters in path如何解决

你已经完成的卸载多版本Git、安装Git for Windows、重启设备、更新VS等操作已排除对应场景问题，以下为补充排查思路：

1 路径合法性校验 #

• 检查本地仓库的完整存储路径，确认没有包含 emoji、非ASCII字符（如中文、小语种字符）、特殊符号（如!@#$%^&*()中的非标准符号、双引号、问号等），路径总长度不要超过Windows默认的260字符限制
• 检查待合并的两个分支中，是否存在文件名/目录名包含上述非法字符的文件，如有先重命名该文件后再尝试合并
• 检查VS的Git可执行文件配置路径：工具 > 选项 > 源代码管理 > Git全局设置 > Git 可执行文件路径，确认该路径本身无非法字符

2 Git环境问题排查 #

• 打开Git Bash执行命令 git config --list --show-origin，检查所有路径类配置项，确认没有包含非法字符的配置
• 尝试清空全局Git配置后重新配置用户身份信息，再测试合并操作
• 绕过VS直接使用Git Bash执行合并指令，如果Git Bash可正常合并，说明问题出在VS的Git集成组件；如果Git Bash也报相同错误，说明问题出在仓库本身或系统路径配置

3 VS本地缓存与配置修复 #

• 进入VS本地缓存目录：直接在资源管理器地址栏输入%localappdata%\Microsoft\VisualStudio\16.0_xxx（16.xxx对应VS2019的版本标识，末尾后缀为随机生成的字符），删除该目录下的ComponentModelCache文件夹
• 重置VS所有设置：工具 > 导入和导出设置 > 重置所有设置，完成后重新关联本地仓库测试
• 在VS的源代码管理面板中移除当前关联的仓库，再重新添加该仓库，重试合并操作

4 系统层面问题排查 #

• 确认当前Windows登录的用户名没有包含非ASCII字符或特殊符号，如有异常可新建一个纯英文用户名的Windows账号，登录后重新拉取仓库测试
• 检查系统环境变量的PATH条目，确认没有包含非法字符的路径，尤其是和Git、VS相关的路径配置
• 开启Windows长路径支持：按下Win+R输入regedit打开注册表，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem，找到LongPathsEnabled项，将值改为1，重启计算机后再测试

内容的提问来源于stack exchange，提问作者Tuvia Khusid