GitHub Pages 上 CSS 未生效，常见原因是选择器作用范围错误、语法拼写错误（如 linear-gradient 拼错或括号嵌套错误）以及样式未正确应用到目标元素。本文将帮你快速定位并修复这些典型问题。
github pages 上 css 未生效，常见原因是选择器作用范围错误、语法拼写错误（如 `linear-gradient` 拼错或括号嵌套错误）以及样式未正确应用到目标元素。本文将帮你快速定位并修复这些典型问题。
在 GitHub Pages（如 username.github.io）中部署静态网站时，HTML 能正常加载，但 CSS 看似“失效”，往往并非路径或服务器问题，而是 CSS 本身存在语法错误或作用域缺失。以你提供的代码为例：
background-image: linear-gradient((rgba(0,0,0,0.5), rgba(0,150,0,0.5));
这段样式存在两个关键问题：
- 缺少选择器：CSS 规则必须绑定到具体元素（如 body、.container），不能孤立书写声明。上面这行代码没有选择器，浏览器直接忽略；
-
语法错误：
- linear-gradient 拼写为 linear-gradiant（多了一个 a，少了一个 e）；
- 多余的左括号：linear-gradient((... 应为 linear-gradient(...，外层括号已由函数自带，无需额外包裹。
✅ 正确写法（应用于整个页面背景）：
body {
background-image: linear-gradient(rgba(0, 0, 0, 0.5), rgba(0, 150, 0, 0.5));
margin: 0; /* 可选：清除默认 body 边距，使背景铺满 */
min-height: 100vh; /* 推荐：确保背景至少覆盖视口高度 */
}
h1, p {
color: white; /* 原答案建议 black，但深绿渐变下 white 更易读 */
text-align: center;
}? 额外检查清单（排查 GitHub Pages CSS 不生效）：
立即学习“前端免费学习笔记（深入）”；
- ✅ 确认 <link> 标签路径正确（推荐使用相对路径，如 <link rel="stylesheet" href="style.css">，且 style.css 与 HTML 同级）；
- ✅ 浏览器开发者工具（F12 → Elements → Styles）查看元素是否被选中、样式是否被划掉（表示被覆盖或语法错误）；
- ✅ 检查控制台（Console）是否有 404（CSS 文件未找到）或 CSS 解析错误（SyntaxError）；
- ✅ GitHub Pages 默认启用 Jekyll；若文件名含 _（如 _style.css）或目录以 _ 开头，Jekyll 会跳过渲染——请避免使用下划线前缀。
? 小技巧：在本地用浏览器直接双击 HTML 文件测试 CSS，可快速区分是代码问题还是部署配置问题。
修复语法、补全选择器、验证路径——三步即可让 CSS 在 GitHub Pages 上稳定生效。作为初学者，建议使用 VS Code 等编辑器开启 CSS 语法校验，并养成在开发者工具中实时调试的习惯。
