vs code 报 css-semicolonexpected 错误是因为内置 css 解析器将 tailwind css v4 的 @import 'tailwindcss' source(none); 当作非法 css 处理，该语法是框架专属指令而非标准 css；正确解法是安装 tailwind css intellisense 扩展，配置 "files.associations": {"*.css": "tailwindcss"} 并确保项目根目录存在合法 tailwind.config.js（module.exports = {}），同时开启 editor.quicksuggestions.strings。
VS Code 对 Tailwind CSS v4 的 @import 'tailwindcss' source(none); 语法报错或无提示，不是插件不兼容，而是默认用标准 CSS 解析器处理它——这个语法根本不是合法 CSS，是 Tailwind 自研的源码注入指令，必须交由 Tailwind IntelliSense 专属解析。
VS Code 报 css-semicolonexpected 错误
这是内置 CSS 语言服务把 @import 'tailwindcss' source(none); 当作普通 CSS 声明解析导致的。它期待属性值后跟分号，但 source(none) 是 Tailwind v4 新增的函数式参数，标准 CSS 不认。
- 别试图在
settings.json里关掉 CSS 校验——那会同时干掉所有真实 CSS 错误提示 - 正确做法是让 VS Code “换人干活”：安装
tailwindcss-intellisense并强制将含该语法的文件（如globals.css）识别为 Tailwind CSS 模式 - 在工作区
.vscode/settings.json中加：{ "files.associations": { "*.css": "tailwindcss" } }，重启窗口即可
tailwind.config.js 必须存在且导出格式严格匹配
v4 插件仍依赖 tailwind.config.js 启动，哪怕你只用 source(none)。它不读取配置内容，但必须能成功 require() 这个文件，否则整个 IntelliSense 降级为哑巴状态。
- 路径必须是项目根目录（即你执行
code .打开的那一层），./src/tailwind.config.js不会被自动发现 - 导出必须用
module.exports = {}；export default {}在未设"type": "module"的项目中会静默失败 - 哪怕空配置也要合法：
module.exports = { content: [] };，不能留空文件或写export {}
JSX/TSX 中类名不提示，90% 是 editor.quickSuggestions.strings 关着
Tailwind 类名几乎全在字符串里：className="text-lg bg-blue-500"、cn("flex", size)、tw`p-4 ${hover ? 'bg-gray-100' : ''}`。而 VS Code 默认关闭字符串内部的自动补全——这不是 Tailwind 的问题，是 VS Code 的全局开关。
- 打开设置（
Ctrl+,），搜editor.quickSuggestions，展开后把strings设为true - 改完不用重启，但得重新打开当前文件，或执行命令
Developer: Reload Window - 若用了
cn()或tw``，还需在settings.json加："tailwindCSS.experimental.classRegex": ["cn\(([^)]*)\)"], "tailwindCSS.experimental.templateStringRegex": "tw`([^`]*)`"
动态类名（如 className={`bg-${color}-500`}）永远不提示
这不是配置缺陷，是设计边界。IntelliSense 靠静态扫描 content 路径下的文本生成候选列表，变量插值、模板拼接、运行时计算的结果无法被提前推断。v4 没改变这点，也不会改。
- 别折腾正则去硬套
${color}——它只会匹配字面量部分，比如bg-和-500，中间那段永远空白 - 若真需强类型保障，改用
theme()函数 + TypeScript 类型推导，或把组合逻辑收进const classes = { primary: 'bg-blue-500', ... }这种对象映射 - 检查右下角是否显示
Tailwind CSS图标：没图标=配置加载失败；有图标但提示缺失=语言模式或字符串开关没开
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
