CodeBuddy中Tailwind任意值和自定义插件类不补全，需重启Tailwind服务、启用arbitraryValueExtensions、验证插件注册、开启CodeBuddy上下文感知扫描，并手动配置arbitraryValueRegex正则匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行 Tailwind CSS 开发时发现任意值（如 text-[#1e293b]）或自定义插件（如 @layer utilities 中定义的类）未被正确补全，则可能是由于 CodeBuddy 当前未对非标准语法路径进行深度解析。以下是解决此问题的步骤：
一、确认 CodeBuddy 是否启用 Tailwind 专用解析引擎
CodeBuddy 默认依赖 VS Code 的语言服务层与 Tailwind CSS IntelliSense 协同工作，其自身不直接接管类名索引；若未桥接官方插件的扫描结果，任意值和自定义插件类将无法进入补全候选池。
1、打开 VS Code 命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2、输入并选择“Tailwind CSS: Restart Tailwind CSS Server”。
立即学习“前端免费学习笔记（深入）”；
3、等待右下角状态栏显示“Tailwind CSS server ready”，再在编辑器中输入 text-[ 观察是否触发颜色值提示。
二、检查 tailwind.config.js 中 arbitraryValueExtensions 配置项
Tailwind v3.4+ 引入 arbitraryValueExtensions 选项用于显式声明支持任意值的类前缀，CodeBuddy 的补全准确率高度依赖该配置是否被正确加载和识别。
1、打开项目根目录下的 tailwind.config.js 文件。
2、确认配置中包含以下内容：
module.exports = { content: ["./src/**/*.{js,jsx,ts,tsx}"], theme: { extend: {} }, plugins: [], experimental: { arbitraryValueExtensions: true } }
3、保存文件后执行 Developer: Reload Window。
三、验证自定义插件是否注册到 Tailwind 插件链并导出完整类名列表
CodeBuddy 不执行插件内部逻辑，仅消费插件通过 addUtilities、addComponents 等 API 注册的类名；若插件使用动态生成或运行时计算（如读取外部 JSON），则类名不会出现在静态索引中。
1、检查自定义插件是否以模块方式导出，且返回对象包含 name 字段和明确的 handlers。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、在插件代码末尾添加调试日志：console.log('Registered classes:', Object.keys(utilities))，并在终端中启动开发服务器观察输出。
3、确保插件被正确引入：在 tailwind.config.js 的 plugins 数组中使用绝对路径或已安装包名，例如 require('./plugins/custom-variants')。
四、启用 CodeBuddy 的 Tailwind 上下文感知增强模式
CodeBuddy 提供实验性 Tailwind 模式，可主动扫描 content 路径内所有字符串字面量并提取潜在类名，对任意值和函数包裹类（如 cn("text-[#1e293b] sm:flex")）提升覆盖度。
1、打开 VS Code 设置（Ctrl+,）。
2、搜索 codebuddy.tailwind.experimental.enableContextAwareScanning。
3、将其值设为 true。
4、重启当前工作区或执行命令 “CodeBuddy: Reload Context Engine”。
五、手动注入任意值正则匹配规则至 settings.json
当 CodeBuddy 与 Tailwind CSS IntelliSense 协作时，可通过扩展配置强制识别常见任意值模式，避免因解析器未覆盖而漏掉补全。
1、按下 Ctrl+Shift+P 打开命令面板，输入并选择 “Preferences: Open Settings (JSON)”。
2、在 settings.json 中添加如下字段：
"tailwindCSS.experimental.arbitraryValueRegex": ["text-\[#[0-9a-fA-F]{3,6}\]", "bg-\[#[0-9a-fA-F]{3,6}\]", "p-\[\d+px\]"]
3、保存后重新打开一个 JSX/TSX 文件，在 className="" 内输入 text-[# 查看是否触发十六进制颜色建议。
