wp_enqueue_style 必须在 wp_enqueue_scripts 钩子中调用，不可直接写在 functions.php 顶层或模板文件中；handle 需唯一带前缀，路径须用 get_template_directory_uri() 等函数生成，$ver 推荐用 filemtime，$deps 应正确声明依赖数组。
wp_enqueue_style 必须在 wp_enqueue_scripts 钩子中调用
直接在主题文件里写 wp_enqueue_style() 会导致样式不加载，甚至触发“headers already sent”错误。WordPress 要求所有资源注册/引入必须通过钩子机制，确保执行时机正确——既不能太早（DOM 和 WP 环境未就绪），也不能太晚（HTML 已输出）。
常见错误现象：wp_enqueue_style() 放在 functions.php 顶层、或放在模板文件（如 header.php）里，结果样式完全不生效，浏览器检查也看不到对应 <link> 标签。
- 必须用
add_action( 'wp_enqueue_scripts', 'your_enqueue_function' )包裹 - 不要在
init、after_setup_theme或wp_head中调用它（时机错位） - 如果主题用了子主题，确保钩子挂载在子主题的
functions.php中，且父主题未禁用子主题钩子
handle 名称重复会导致样式被意外覆盖或跳过
wp_enqueue_style() 的第一个参数是 handle，它既是唯一标识，也是依赖管理依据。一旦两个插件或主题用了相同 handle（比如都用 'bootstrap'），后注册的那个会把前一个干掉——不是合并，是彻底忽略。
使用场景：你引入自定义 CSS，同时又装了用同样 handle 的插件（如某页构建器也注册了 'mytheme-style'），你的样式就消失了，但控制台毫无报错。
- handle 建议带前缀，如
'mytheme-custom-css'或'pluginname-admin-ui' - 用
wp_style_is( 'handle-name', 'enqueued' )可临时检查是否已被加载 - 若需替换默认样式（如主题自带的
'twentytwentyfour-style'），应先wp_dequeue_style()再重新wp_enqueue_style()，不能只覆盖 handle
路径参数写错是 404 最常见原因
wp_enqueue_style() 的第二个参数是 CSS 文件路径，它不是服务器绝对路径，也不是相对当前 PHP 文件的路径，而是「相对于站点根目录」或「由 WordPress 解析的 URL 路径」。写成 ./css/style.css 或 ../assets/css/main.css 几乎必 404。
性能影响：路径错误不会报 PHP 错，但浏览器会发无效请求，拖慢首屏渲染，还可能触发 CDN 缓存脏数据。
- 主题内样式推荐用
get_template_directory_uri() . '/css/custom.css' - 子主题用
get_stylesheet_directory_uri()（不是_template_） - 避免硬编码域名；不用
__DIR__或dirname(__FILE__)拼 URL - 开发时打开浏览器 Network 面板，过滤
css，一眼看出 404 请求源
版本号和依赖项不填可能引发缓存与加载顺序问题
第四个参数（$ver）为空时，WordPress 默认用当前 WordPress 版本号。这会让 CSS 缓存失效不可控——改了文件内容但 URL 没变，用户浏览器还在用旧缓存。
第三个参数（$deps）为空则意味着无依赖，但如果该 CSS 依赖 wp-block-library 或某个基础框架，没声明会导致样式错乱（比如 CSS 变量未定义、选择器优先级异常）。
-
$ver推荐用文件修改时间：filemtime( get_stylesheet_directory() . '/css/custom.css' ) -
$deps是数组，如array( 'wp-blocks', 'wp-components' )，不是字符串 - 依赖项 handle 必须已由其他地方注册过（可用
wp_get_style( $handle )检查是否存在） - 若只是普通样式，
$deps可留空数组array()，但别传null或省略参数
最常被忽略的是：子主题里改了父主题 CSS 后，忘了更新 $ver，用户端永远看不到新样式——这事没法靠清缓存解决，得动代码。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
