VS Code预览正常，GitHub Pages部署后简历照片不显示求助

AI 小北

2026-7-19

问题排查与解决方法

路径大小写不匹配：GitHub文件系统区分大小写，但本地Windows/macOS默认不区分。比如代码里写的是./images/photo.jpg，但实际上传的文件是./images/Photo.jpg，本地预览正常，GitHub上却会找不到文件。务必保证代码引用路径和仓库中文件名的大小写完全一致。
相对路径基准错误：VS Code本地预览以本地文件系统为基准，而GitHub Pages部署后，网站根路径是你的仓库名称（例如https://你的用户名.github.io/简历仓库名/）。如果用了绝对路径/images/photo.jpg，本地能从根目录找到，但GitHub Pages下实际根目录是仓库子目录，需改成相对路径./images/photo.jpg，或基于仓库的绝对路径/简历仓库名/images/photo.jpg。
.gitignore拦截图片文件：检查项目根目录的.gitignore文件，确认是否误将图片所在文件夹（比如images/）加入忽略规则，导致图片根本没上传到GitHub仓库。删除对应忽略规则后，重新提交图片文件。
GitHub Pages部署缓存：部署后可能存在缓存，即使重新上传图片，浏览器仍加载旧内容。可强制刷新页面（Ctrl+F5或Cmd+Shift+R），或等待10-15分钟让部署完全生效。
图片文件上传不完整/损坏：直接在GitHub仓库中点击图片文件，查看能否正常打开。若无法打开，重新对图片进行压缩（比如转成webp格式缩小体积）后再上传。
img标签src属性错误：检查代码中src是否带有多余空格、特殊字符，或使用了本地绝对路径（如C:/Users/xxx/photo.jpg），这类路径在GitHub上无法访问，必须改为仓库内的相对路径。