WordPress 要求通过 wp_enqueue_style() 在 functions.php 中注册并加载 CSS，而非直接在 HTML 中使用 标签——否则将导致样式不生效、路径错误或与主题/插件冲突。
wordpress 要求通过 `wp_enqueue_style()` 在 `functions.php` 中注册并加载 css，而非直接在 html 中使用 `` 标签——否则将导致样式不生效、路径错误或与主题/插件冲突。
在 WordPress 主题开发中，直接在 header.php 或模板片段（如 template-parts/template-header.php）中硬编码 <link rel="stylesheet" href="homepage.css"> 是不推荐且通常无效的做法。原因包括：
- WordPress 使用动态 URL 结构，相对路径（如
"homepage.css"）极易因模板嵌套层级变化而失效； - 主题目录结构与实际请求路径不一致（例如
template-parts/是 PHP 包含路径，不是 Web 可访问的公开路径）； - 缺少依赖管理、版本控制和条件加载能力；
- 无法确保样式在 WordPress 样式队列中正确排序（可能被其他样式覆盖或提前加载）；
- 违反 WordPress 安全与性能最佳实践（如无法自动添加版本号防缓存、不支持 RTL 或多设备适配钩子）。
✅ 正确做法：在主题根目录下的 functions.php 中使用 wp_enqueue_style() 注册并加载 CSS。
示例：为首页加载专用样式
// functions.php
function mytheme_enqueue_styles() {
// 主题基础样式（style.css）
wp_enqueue_style(
'mytheme-style',
get_stylesheet_uri(),
array(),
wp_get_theme()->get('Version')
);
// 首页专用样式（假设位于主题根目录：/homepage.css）
if (is_front_page() || is_home()) {
wp_enqueue_style(
'mytheme-homepage',
get_template_directory_uri() . '/homepage.css',
array('mytheme-style'), // 依赖主样式，确保其先加载
filemtime(get_template_directory() . '/homepage.css') // 自动更新版本号，避免缓存
);
}
}
add_action('wp_enqueue_scripts', 'mytheme_enqueue_styles');?
get_template_directory_uri()返回主题的可访问 URL 路径（如https://yoursite.com/wp-content/themes/mytheme/），务必用它替代相对路径或__DIR__等服务器路径。
SEO Keyword Density下载SEO关键词密度优化与页面审计技能。使用场景：①提供页面路径与关键词进行SEO优化；②提升页面关键词密度；③提升搜索引擎排名；④进行SEO审计（meta标签、OG、hreflang等）。触发词：关键词密度、SEO优化、关键词优化等。
注意事项：
- ✅ CSS 文件应放在主题根目录（如
/homepage.css）或明确的静态资源目录（如/assets/css/homepage.css），不要放在template-parts/内——该目录仅用于 PHP 模板片段，不对外提供 HTTP 访问。 - ✅ 始终使用
wp_enqueue_scripts钩子（而非init或wp_head），这是 WordPress 官方指定的样式/脚本加载时机。 - ✅ 为避免缓存问题，建议用
filemtime()生成动态版本号（如上例），而非手动写死?ver=1.0。 - ❌ 删除所有模板文件中的
<link rel="stylesheet">标签——它们在此上下文中无效且可能引发重复加载或 404。
遵循此方式，不仅能确保 CSS 正常加载，还能兼容 WordPress 的样式优先级、RTL 支持、子主题继承及 CDN/优化插件（如 Autoptimize）。这是构建健壮、可维护 WordPress 主题的必备基础。
立即学习“前端免费学习笔记（深入）”；
