编程马·菜鸟教程

Appearance

4.2 编写 style.css：设置主题信息、基础样式 ​

style.css是WordPress主题的核心文件之一，它不仅包含主题的样式定义，还包含主题的元数据信息。编写规范的style.css文件是主题开发的重要步骤。本章节将详细介绍如何编写style.css文件，包括设置主题信息和基础样式。

设置主题信息头 ​

主题信息头是style.css文件顶部的注释部分，包含主题的基本信息。WordPress通过这些信息来识别主题，并在主题管理界面中显示。

必需字段 ​

以下字段是WordPress主题必需的：

  1. Theme Name：主题名称
  2. Author：作者名称
  3. Description：主题描述
  4. Version：主题版本
  5. License：许可证
  6. License URI：许可证链接
  7. Text Domain：文本域

可选字段 ​

以下字段是可选的，但推荐添加：

  1. Theme URI：主题官网链接
  2. Author URI：作者官网链接
  3. Tags：主题标签
  4. Requires at least：最低WordPress版本要求
  5. Tested up to：测试通过的WordPress版本
  6. Requires PHP：最低PHP版本要求

主题信息头示例 ​

css
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-custom-theme
Author: Your Name
Author URI: https://example.com
Description: A responsive WordPress theme for beginners
Version: 1.0.0
License: GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: my-custom-theme
Tags: blog, responsive, custom-logo, custom-menu, featured-images
Requires at least: 5.0
Tested up to: 6.0
Requires PHP: 7.0
*/

编写基础样式 ​

在主题信息头之后，你需要编写主题的基础样式。基础样式应该包括：

1. 全局样式 ​

全局样式定义了整个网站的基本样式，如字体、颜色、背景等。

css
/* 全局样式 */
:root {
    --primary-color: #333;
    --secondary-color: #666;
    --accent-color: #007bff;
    --background-color: #f5f5f5;
    --text-color: #333;
    --font-family: 'Arial', sans-serif;
}

* {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

body {
    font-family: var(--font-family);
    line-height: 1.6;
    color: var(--text-color);
    background-color: var(--background-color);
}

/* 容器样式 */
.container {
    width: 100%;
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 20px;
}

2. 头部样式 ​

头部样式定义了网站头部的样式，如网站标题、导航菜单等。

css
/* 头部样式 */
header {
    background-color: #fff;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    padding: 1rem 0;
}

.header-content {
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.logo {
    font-size: 1.5rem;
    font-weight: bold;
    color: var(--primary-color);
    text-decoration: none;
}

nav ul {
    list-style: none;
    display: flex;
    gap: 1rem;
}

nav ul li a {
    color: var(--primary-color);
    text-decoration: none;
    font-weight: 500;
    transition: color 0.3s ease;
}

nav ul li a:hover {
    color: var(--accent-color);
}

/* 移动菜单按钮 */
.menu-toggle {
    display: none;
    background: none;
    border: none;
    font-size: 1.5rem;
    cursor: pointer;
}

3. 主内容区域样式 ​

主内容区域样式定义了网站主体内容的样式，如文章列表、页面内容等。

css
/* 主内容区域样式 */
main {
    padding: 2rem 0;
}

/* 文章列表样式 */
.post-list {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
    gap: 2rem;
    margin-bottom: 2rem;
}

.post-item {
    background-color: #fff;
    padding: 1.5rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    transition: transform 0.3s ease, box-shadow 0.3s ease;
}

.post-item:hover {
    transform: translateY(-5px);
    box-shadow: 0 5px 15px rgba(0,0,0,0.1);
}

.post-item h2 {
    margin-bottom: 1rem;
}

.post-item h2 a {
    color: var(--primary-color);
    text-decoration: none;
    transition: color 0.3s ease;
}

.post-item h2 a:hover {
    color: var(--accent-color);
}

.post-meta {
    font-size: 0.9rem;
    color: var(--secondary-color);
    margin-bottom: 1rem;
}

.post-excerpt {
    margin-bottom: 1rem;
}

.read-more {
    display: inline-block;
    padding: 0.5rem 1rem;
    background-color: var(--accent-color);
    color: #fff;
    text-decoration: none;
    border-radius: 4px;
    transition: background-color 0.3s ease;
}

.read-more:hover {
    background-color: #0069d9;
}

/* 单篇文章样式 */
.single-post {
    background-color: #fff;
    padding: 2rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    margin-bottom: 2rem;
}

.single-post h1 {
    margin-bottom: 1rem;
    color: var(--primary-color);
}

.post-thumbnail {
    margin-bottom: 1.5rem;
}

.post-thumbnail img {
    width: 100%;
    height: auto;
    border-radius: 8px;
}

.post-content {
    margin-bottom: 2rem;
}

.post-tags {
    margin-top: 2rem;
    padding-top: 1rem;
    border-top: 1px solid #eee;
}

4. 侧边栏样式 ​

侧边栏样式定义了网站侧边栏的样式，如小工具区域等。

css
/* 侧边栏样式 */
.sidebar {
    background-color: #fff;
    padding: 1.5rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}

.widget {
    margin-bottom: 2rem;
}

.widget-title {
    font-size: 1.2rem;
    margin-bottom: 1rem;
    color: var(--primary-color);
    border-bottom: 2px solid var(--accent-color);
    padding-bottom: 0.5rem;
}

.widget ul {
    list-style: none;
}

.widget ul li {
    margin-bottom: 0.5rem;
}

.widget ul li a {
    color: var(--primary-color);
    text-decoration: none;
    transition: color 0.3s ease;
}

.widget ul li a:hover {
    color: var(--accent-color);
}

/* 搜索表单样式 */
.search-form {
    margin-bottom: 1rem;
}

.search-form input[type="search"] {
    width: 100%;
    padding: 0.5rem;
    border: 1px solid #ddd;
    border-radius: 4px;
    margin-bottom: 0.5rem;
}

.search-form input[type="submit"] {
    padding: 0.5rem 1rem;
    background-color: var(--accent-color);
    color: #fff;
    border: none;
    border-radius: 4px;
    cursor: pointer;
    transition: background-color 0.3s ease;
}

.search-form input[type="submit"]:hover {
    background-color: #0069d9;
}

5. 底部样式 ​

底部样式定义了网站底部的样式，如版权信息、底部导航等。

css
/* 底部样式 */
footer {
    background-color: var(--primary-color);
    color: #fff;
    padding: 2rem 0;
    margin-top: 2rem;
}

.footer-content {
    display: flex;
    flex-wrap: wrap;
    gap: 2rem;
    margin-bottom: 1.5rem;
}

.footer-info {
    flex: 1;
    min-width: 250px;
}

.footer-info h3 {
    font-size: 1.2rem;
    margin-bottom: 1rem;
}

.footer-links {
    flex: 1;
    min-width: 250px;
}

.footer-links h3 {
    font-size: 1.2rem;
    margin-bottom: 1rem;
}

.footer-links ul {
    list-style: none;
}

.footer-links li {
    margin-bottom: 0.5rem;
}

.footer-links a {
    color: #ccc;
    text-decoration: none;
    transition: color 0.3s ease;
}

.footer-links a:hover {
    color: #fff;
}

.footer-copyright {
    text-align: center;
    padding-top: 1.5rem;
    border-top: 1px solid rgba(255,255,255,0.1);
    font-size: 0.9rem;
}

6. 响应式设计 ​

响应式设计确保网站在不同屏幕尺寸上都能正常显示。

css
/* 响应式设计 */
@media (max-width: 768px) {
    /* 头部响应式 */
    .header-content {
        flex-direction: column;
        align-items: flex-start;
    }
    
    nav {
        width: 100%;
        margin-top: 1rem;
    }
    
    nav ul {
        flex-direction: column;
        gap: 0.5rem;
    }
    
    /* 文章列表响应式 */
    .post-list {
        grid-template-columns: 1fr;
    }
    
    /* 底部响应式 */
    .footer-content {
        flex-direction: column;
    }
    
    /* 单篇文章响应式 */
    .single-post {
        padding: 1.5rem;
    }
}

@media (max-width: 480px) {
    /* 容器响应式 */
    .container {
        padding: 0 15px;
    }
    
    /* 头部响应式 */
    .logo {
        font-size: 1.2rem;
    }
    
    /* 单篇文章响应式 */
    .single-post h1 {
        font-size: 1.5rem;
    }
    
    /* 底部响应式 */
    .footer-info,
    .footer-links {
        min-width: 100%;
    }
}

完整的 style.css 文件示例 ​

css
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-custom-theme
Author: Your Name
Author URI: https://example.com
Description: A responsive WordPress theme for beginners
Version: 1.0.0
License: GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: my-custom-theme
Tags: blog, responsive, custom-logo, custom-menu, featured-images
Requires at least: 5.0
Tested up to: 6.0
Requires PHP: 7.0
*/

/* 全局样式 */
:root {
    --primary-color: #333;
    --secondary-color: #666;
    --accent-color: #007bff;
    --background-color: #f5f5f5;
    --text-color: #333;
    --font-family: 'Arial', sans-serif;
}

* {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

body {
    font-family: var(--font-family);
    line-height: 1.6;
    color: var(--text-color);
    background-color: var(--background-color);
}

/* 容器样式 */
.container {
    width: 100%;
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 20px;
}

/* 头部样式 */
header {
    background-color: #fff;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    padding: 1rem 0;
}

.header-content {
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.logo {
    font-size: 1.5rem;
    font-weight: bold;
    color: var(--primary-color);
    text-decoration: none;
}

nav ul {
    list-style: none;
    display: flex;
    gap: 1rem;
}

nav ul li a {
    color: var(--primary-color);
    text-decoration: none;
    font-weight: 500;
    transition: color 0.3s ease;
}

nav ul li a:hover {
    color: var(--accent-color);
}

/* 移动菜单按钮 */
.menu-toggle {
    display: none;
    background: none;
    border: none;
    font-size: 1.5rem;
    cursor: pointer;
}

/* 主内容区域样式 */
main {
    padding: 2rem 0;
}

/* 文章列表样式 */
.post-list {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
    gap: 2rem;
    margin-bottom: 2rem;
}

.post-item {
    background-color: #fff;
    padding: 1.5rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    transition: transform 0.3s ease, box-shadow 0.3s ease;
}

.post-item:hover {
    transform: translateY(-5px);
    box-shadow: 0 5px 15px rgba(0,0,0,0.1);
}

.post-item h2 {
    margin-bottom: 1rem;
}

.post-item h2 a {
    color: var(--primary-color);
    text-decoration: none;
    transition: color 0.3s ease;
}

.post-item h2 a:hover {
    color: var(--accent-color);
}

.post-meta {
    font-size: 0.9rem;
    color: var(--secondary-color);
    margin-bottom: 1rem;
}

.post-excerpt {
    margin-bottom: 1rem;
}

.read-more {
    display: inline-block;
    padding: 0.5rem 1rem;
    background-color: var(--accent-color);
    color: #fff;
    text-decoration: none;
    border-radius: 4px;
    transition: background-color 0.3s ease;
}

.read-more:hover {
    background-color: #0069d9;
}

/* 单篇文章样式 */
.single-post {
    background-color: #fff;
    padding: 2rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
    margin-bottom: 2rem;
}

.single-post h1 {
    margin-bottom: 1rem;
    color: var(--primary-color);
}

.post-thumbnail {
    margin-bottom: 1.5rem;
}

.post-thumbnail img {
    width: 100%;
    height: auto;
    border-radius: 8px;
}

.post-content {
    margin-bottom: 2rem;
}

.post-tags {
    margin-top: 2rem;
    padding-top: 1rem;
    border-top: 1px solid #eee;
}

/* 侧边栏样式 */
.sidebar {
    background-color: #fff;
    padding: 1.5rem;
    border-radius: 8px;
    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
}

.widget {
    margin-bottom: 2rem;
}

.widget-title {
    font-size: 1.2rem;
    margin-bottom: 1rem;
    color: var(--primary-color);
    border-bottom: 2px solid var(--accent-color);
    padding-bottom: 0.5rem;
}

.widget ul {
    list-style: none;
}

.widget ul li {
    margin-bottom: 0.5rem;
}

.widget ul li a {
    color: var(--primary-color);
    text-decoration: none;
    transition: color 0.3s ease;
}

.widget ul li a:hover {
    color: var(--accent-color);
}

/* 搜索表单样式 */
.search-form {
    margin-bottom: 1rem;
}

.search-form input[type="search"] {
    width: 100%;
    padding: 0.5rem;
    border: 1px solid #ddd;
    border-radius: 4px;
    margin-bottom: 0.5rem;
}

.search-form input[type="submit"] {
    padding: 0.5rem 1rem;
    background-color: var(--accent-color);
    color: #fff;
    border: none;
    border-radius: 4px;
    cursor: pointer;
    transition: background-color 0.3s ease;
}

.search-form input[type="submit"]:hover {
    background-color: #0069d9;
}

/* 底部样式 */
footer {
    background-color: var(--primary-color);
    color: #fff;
    padding: 2rem 0;
    margin-top: 2rem;
}

.footer-content {
    display: flex;
    flex-wrap: wrap;
    gap: 2rem;
    margin-bottom: 1.5rem;
}

.footer-info {
    flex: 1;
    min-width: 250px;
}

.footer-info h3 {
    font-size: 1.2rem;
    margin-bottom: 1rem;
}

.footer-links {
    flex: 1;
    min-width: 250px;
}

.footer-links h3 {
    font-size: 1.2rem;
    margin-bottom: 1rem;
}

.footer-links ul {
    list-style: none;
}

.footer-links li {
    margin-bottom: 0.5rem;
}

.footer-links a {
    color: #ccc;
    text-decoration: none;
    transition: color 0.3s ease;
}

.footer-links a:hover {
    color: #fff;
}

.footer-copyright {
    text-align: center;
    padding-top: 1.5rem;
    border-top: 1px solid rgba(255,255,255,0.1);
    font-size: 0.9rem;
}

/* 响应式设计 */
@media (max-width: 768px) {
    /* 头部响应式 */
    .header-content {
        flex-direction: column;
        align-items: flex-start;
    }
    
    nav {
        width: 100%;
        margin-top: 1rem;
    }
    
    nav ul {
        flex-direction: column;
        gap: 0.5rem;
    }
    
    /* 文章列表响应式 */
    .post-list {
        grid-template-columns: 1fr;
    }
    
    /* 底部响应式 */
    .footer-content {
        flex-direction: column;
    }
    
    /* 单篇文章响应式 */
    .single-post {
        padding: 1.5rem;
    }
}

@media (max-width: 480px) {
    /* 容器响应式 */
    .container {
        padding: 0 15px;
    }
    
    /* 头部响应式 */
    .logo {
        font-size: 1.2rem;
    }
    
    /* 单篇文章响应式 */
    .single-post h1 {
        font-size: 1.5rem;
    }
    
    /* 底部响应式 */
    .footer-info,
    .footer-links {
        min-width: 100%;
    }
}

最佳实践 ​

  1. 信息头完整性：确保主题信息头包含所有必需字段
  2. 样式组织：使用清晰的注释和分组组织样式
  3. 命名规范：使用语义化的类名和BEM命名规范
  4. 响应式设计：使用媒体查询和相对单位实现响应式设计
  5. 性能优化：
    • 减少CSS文件的大小
    • 避免使用过多的嵌套选择器
    • 使用CSS变量减少重复代码
  6. 兼容性：
    • 添加必要的浏览器前缀
    • 测试在不同浏览器中的显示效果
  7. 可维护性：
    • 添加清晰的注释
    • 保持代码的一致性
    • 定期更新和优化样式

常见错误及解决方法 ​

1. 主题信息头不完整 ​

问题：主题信息头缺少必需字段，导致WordPress无法识别主题

解决方法：

  • 确保包含所有必需字段
  • 检查字段名称的拼写是否正确
  • 确保信息头格式正确，使用注释格式

2. 样式冲突 ​

问题：主题样式与插件或其他主题的样式冲突

解决方法：

  • 使用更具体的选择器
  • 避免使用!important
  • 使用CSS变量统一管理样式

3. 响应式设计问题 ​

问题：主题在不同屏幕尺寸下显示异常

解决方法：

  • 使用媒体查询针对不同屏幕尺寸设置样式
  • 测试在各种设备上的显示效果
  • 使用灵活的布局方案

4. 性能问题 ​

问题：CSS文件过大，影响页面加载速度

解决方法：

  • 压缩CSS文件
  • 移除未使用的样式
  • 使用CSS预处理器（如Sass、Less）组织代码

小结 ​

style.css文件是WordPress主题的重要组成部分，它不仅包含主题的样式定义，还包含主题的元数据信息。通过本章节的学习，你应该：

  1. 了解如何设置主题信息头
  2. 掌握如何编写基础样式
  3. 了解如何实现响应式设计
  4. 掌握样式编写的最佳实践
  5. 了解常见错误及解决方法

在后续的章节中，我们将详细介绍如何编写其他核心文件，以及如何构建完整的WordPress主题。

© 2026 编程马·菜鸟教程 版权所有

基于 VitePress 构建