wp_enqueue_style 必须在 wp_enqueue_scripts 钩子中调用，handle 需唯一前缀且避免冲突，$src 必须为 URL 而非服务器路径，$deps 和 $ver 应显式声明以确保加载顺序与缓存更新。
wp_enqueue_style 不在 wp_enqueue_scripts 钩子中调用就根本不会执行
直接把 wp_enqueue_style() 写在 functions.php 顶层，或塞进 header.php，函数压根不运行——PHP 会报 Fatal error: Call to undefined function wp_enqueue_style()（因为 WP 核心函数尚未加载），或者更隐蔽地“静默失败”：浏览器源码里看不到 <link> 标签，控制台也无报错。
WordPress 要求资源注册必须发生在特定时机：
- 早于 wp_enqueue_scripts（比如 init）→ WP 环境未就绪，函数不可用；
- 晚于它（比如 wp_head）→ 已输出，PHP 报 “headers already sent”。
✅ 唯一安全写法：add_action('wp_enqueue_scripts', 'my_theme_enqueue_styles');
并在 my_theme_enqueue_styles() 函数里调用 wp_enqueue_style()。
handle 名称重复会导致样式被覆盖且毫无提示
你写 wp_enqueue_style('style', ...)，插件或父主题也用了 'style' 作为 handle，后注册的那个会彻底干掉前一个——不是合并，不是警告，你的 CSS 就是不生效，连浏览器 Network 面板都看不到请求。
常见踩坑点：
- 用通用名如 'bootstrap'、'main'、'style'；
- 子主题没加前缀，直接复用父主题 handle；
- 多个自定义样式共用同一个 handle。
✅ 正确做法：
- handle 加唯一前缀：'mytheme-header-css'、'childtheme-custom-print'；
- 检查是否已存在：wp_style_is('mytheme-header-css', 'enqueued') 返回 true 表示已被加载；
- 替换默认样式（如 'twentytwentyfour-style'）需先 wp_dequeue_style('twentytwentyfour-style')，再重新 wp_enqueue_style()。
$src 必须是 URL，不是服务器路径
传入 __DIR__ . '/css/main.css' 或 get_template_directory() . '/style.css'，结果就是 404——WordPress 不解析服务器路径，只认浏览器能直接访问的 URL。
Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。
不同场景对应不同 URL 生成函数：
- 主题根目录 style.css → get_stylesheet_uri()；
- 父主题 CSS（子主题中引用）→ get_template_directory_uri() . '/assets/css/main.css'；
- 子主题自定义 CSS → get_stylesheet_directory_uri() . '/css/custom.css'；
- 插件内 CSS → plugin_dir_url(__FILE__) . 'css/admin.css'（比 plugins_url() 更稳）。
⚠️ 特别注意：get_template_directory() 返回的是服务器绝对路径，get_template_directory_uri() 才返回 URL；拼错斜杠、漏掉协议、多加点号都会导致 404。
立即学习“前端免费学习笔记（深入）”；
$deps 和 $ver 参数省略会引发兼容性与缓存问题
省略 $deps 或 $ver，PHP 8+ 会触发 warning；更重要的是：
- 不声明依赖（比如你的 custom.css 依赖 bootstrap.css），加载顺序错乱，样式失效；
- 不设 $ver，浏览器可能长期缓存旧 CSS，改了也不生效。
✅ 推荐写法：
- $ver 用文件修改时间：filemtime(get_stylesheet_directory() . '/css/main.css')；
- $deps 显式声明数组：array('parent-style', 'bootstrap-css')；
- $media 按需指定：'screen'、'print' 或 'all'。
子主题中若需继承父主题样式，必须显式声明依赖，不能指望父主题自动加载——父主题的 wp_enqueue_style() 是独立执行的，子主题不挂载自己的钩子，就不会触发任何加载。
