GitHub上传项目文件后输出与VS Code Go-Live服务器差异问题咨询

• 相对路径与部署根目录不匹配
  VS Code Go-Live默认把项目文件夹作为根目录（比如http://localhost:5500/），但GitHub Pages部署后，项目会放在仓库名对应的子路径下（比如https://xxx.github.io/your-repo/）。如果HTML/CSS里用了根路径开头的资源引用（比如/css/main.css），本地能正常加载，但在GitHub Pages里会去https://xxx.github.io/css/main.css找文件，自然找不到。缺失样式后，浏览器会用默认基础样式渲染，字体、布局都会变大变乱，看起来和本地完全不同。

• 文件名大小写不兼容
  Windows系统不区分文件名大小写（比如Main.css和main.css会被当成同一个文件），但GitHub服务器基于Linux，严格区分大小写。如果本地代码里引用的是/css/Main.css，但实际文件是main.css，本地Go-Live能正常加载资源，到GitHub上就会加载失败，同样导致样式丢失，页面渲染异常。

• 换行符或编码格式差异
  上传GitHub时，Git默认会把Windows的CRLF换行符转换成Linux的LF换行符。少数老旧的CSS/JS解析器可能对换行符敏感，转换后出现语法解析错误，导致样式或脚本无法正常执行，页面布局崩溃、内容显示异常。

• base标签配置错误
  如果HTML里设置了<base href="/">，这个配置在本地根目录环境下没问题，但在GitHub Pages的子目录部署场景下，需要改成<base href="/your-repo-name/">。base标签错误会导致所有相对路径的资源引用都指向错误位置，进而引发样式缺失、页面变形。

内容的提问来源于stack exchange，提问作者Harish Sm