🐛 [BUG] Windows11 下启动报错 Can't resolve 'tailwindcss'

[LinAsan-1205]

🐛 bug 描述

在 Windows 11 环境下，使用 ant-design-pro@6.0.0 创建项目并安装依赖后，执行 npm start 启动开发服务器时，报错 Error: Can't resolve 'tailwindcss'。同一项目在同一台机器的 WSL (Ubuntu) 环境下可以正常启动。

📷 复现步骤

1. 在 Windows 11 环境下克隆项目：

   git clone --depth 1 https://github.com/ant-design/ant-design-pro.git my-project
   cd my-project
   npm install

2. 安装完成后执行启动命令：

   npm start

3. 控制台出现 Error: Can't resolve 'tailwindcss' 错误，启动失败。

🏞 期望结果

Windows 环境下应能正常启动开发服务器，与 WSL / macOS / Linux 行为保持一致。

💻 复现代码 | Recurrence code

完整错误日志：

C:\Users\Administrator\Desktop\demo\my-project-test>npm start

> ant-design-pro@6.0.0 start
> cross-env UMI_ENV=dev max dev

info  - [你知道吗？] 如果想检测未使用的文件和导出，可尝试新出的 deadCode 配置项，详见 https://umijs.org/docs/api/config#deadcode
info  - [plugin: ./node_modules/@umijs/plugins/dist/react-query] [reactQuery] use local package, version: 5.100.6
Using openapi Plugin
Error: Can't resolve 'tailwindcss' in 'C:\Users\Administrator\Desktop\demo\Desktop\demo\my-project-test\src'
    [at finishWithoutResolve (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:909:18)]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:1001:14]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
    [at eval (eval at create (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\tapable\lib\HookCodeFactory.js:31:10), <anonymous>:15:1)]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
    [at eval (eval at create (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\tapable\lib\HookCodeFactory.js:31:10), <anonymous>:27:1)]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\DescriptionFilePlugin.js:97:43]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
    [at eval (eval at create (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\tapable\lib\HookCodeFactory.js:31:10), <anonymous>:15:1)]
    [at C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\enhanced-resolve\lib\Resolver.js:1080:5] {
  details: "resolve 'tailwindcss' in 'C:\\Users\\Administrator\\Desktop\\demo\\Desktop\\demo\\my-project-test\\src'\n" +
    '  Parsed request is a module\n' +
    '  using description file: C:\\Users\\Administrator\\package.json (relative path: ./Desktop/demo/Desktop/demo/my-project-test/src)\n' +
    '    resolve as module\n' +
    "      C:\\Users\\Administrator\\Desktop\\demo\\Desktop\\demo\\my-project-test\\src\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\Users\\Administrator\\Desktop\\demo\\Desktop\\demo\\my-project-test\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\Users\\Administrator\\Desktop\\demo\\Desktop\\demo\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\Users\\Administrator\\Desktop\\demo\\Desktop\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\Users\\Administrator\\Desktop\\demo\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\Users\\Administrator\\Desktop\\node_modules doesn't exist or is not a directory\n" +
    '      looking for modules in C:\\Users\\Administrator\\node_modules\n' +
    '        single file module\n' +
    '          using description file: C:\\Users\\Administrator\\package.json (relative path: ./node_modules/tailwindcss)\n' +
    '            no extension\n' +
    "              C:\\Users\\Administrator\\node_modules\\tailwindcss doesn't exist\n" +
    '            .css\n' +
    "              C:\\Users\\Administrator\\node_modules\\tailwindcss.css doesn't exist\n" +
    "        C:\\Users\\Administrator\\node_modules\\tailwindcss doesn't exist\n" +
    "      C:\\Users\\node_modules doesn't exist or is not a directory\n" +
    "      C:\\node_modules doesn't exist or is not a directory"
}
ModuleBuildError: ./Desktop/demo/my-project-test/src/tailwind.css
Error evaluating Node.js code
CssSyntaxError: tailwindcss: C:\Users\Administrator\Desktop\demo\Desktop\demo\my-project-test\src\tailwind.css:1:1: Can't resolve 'tailwindcss' in 'C:\Users\Administrator\Desktop\demo\Desktop\demo\my-project-test\src'
    [at Input.error (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\postcss\lib\input.js:135:16)]
    [at Root.error (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\postcss\lib\node.js:146:32)]
    [at Object.Once (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@tailwindcss\postcss\dist\index.js:10:6913)]
    [at process.processTicksAndRejections (node:internal/process/task_queues:105:5)]
    [at async LazyResult.runAsync (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\postcss\lib\lazy-result.js:293:11)]
    at async transform (turbopack:///[turbopack-node]/transforms/postcss.ts:75:34) [C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack\cjs\.turbopack\_root-of-the-server___1f5b2553.js:132:44]
    at async run (turbopack:///[turbopack-node]/child_process/evaluate.ts:89:23) [C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack\cjs\.turbopack\_root-of-the-server___689ab38f.js:73:31]


    at processIssues (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack-shared\cjs\utils.js:38:15)
    at writeEntrypointToDisk (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack\cjs\core\hmr.js:132:36)
    at async Promise.all (index 0)
    at async writeEntrypointsToDisk (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack\cjs\core\hmr.js:136:9)
    at async handleEntrypointsSubscription (C:\Users\Administrator\Desktop\demo\my-project-test\node_modules\@utoo\pack\cjs\core\hmr.js:265:13)

© 版本信息

• Ant Design Pro 版本: 6.0.0
• umi 版本: 4.6.49
• Node.js 版本: v24.0.1
• 包管理器: npm
• 浏览器环境: Chrome / Edge
• 开发环境: Windows 11
• 补充：同一项目在同一台机器的 WSL2 (Ubuntu 22.04) 下 npm start 可正常启动

🚑 其他信息

• 已确认 node_modules/tailwindcss 目录存在且文件完整。
• 尝试过删除 node_modules 和 package-lock.json 重新安装，问题依旧。

[afc163]

#11749

@LinAsan-1205 帮忙验证一下？

[afc163]

感谢反馈！根据分析，有几个需要进一步确认的信息：

已确认的问题

src/tailwind.css 中 @source "./src" 指令有误 — @source 路径是相对于 CSS 文件本身解析的，从 src/tailwind.css 出发 ./src 会指向不存在的 src/src/ 目录。已在 #11749 中修复为 @source "."。

关于 Can't resolve 'tailwindcss' 错误

从错误日志中可以看到路径被翻倍了（Desktop\demo 出现了两次）：

resolve 'tailwindcss' in 'C:\Users\Administrator\Desktop\demo\Desktop\demo\my-project-test\src'

但本项目 CI 在 windows-latest 上运行 ut build 是通过的，说明这不是一个通用的 turbopack Windows 问题。为了进一步定位，能否提供以下信息？

1. 你的 Desktop 目录是否开启了 OneDrive 同步？ Windows 上 OneDrive 会将 Desktop 重定向为 junction/symlink，这可能导致路径解析异常
2. 换一个不在 Desktop 下的目录（如 C:\Projects\test）试试是否还复现？
3. 使用 Node.js v20（CI 使用的版本）是否能正常启动？ 你的环境使用了 v24.0.1
4. 运行 npm run build 是否正常？ CI 跑的是 build，而你报告的是 npm start（dev 模式）

这些信息可以帮助缩小问题范围，判断是路径相关、Node 版本相关还是 dev 模式特有的问题。

[LinAsan-1205]

感谢反馈！根据分析，有一些需要进一步确认的信息：

已确认的问题

src/tailwind.css中@source "./src"指令有误 —@source路径是相对于 CSS 文件本身解析的，从src/tailwind.css出发./src会指向不存在的src/src/目录。已在#11749中修复为@source "."。

关于Can't resolve 'tailwindcss'错误

从错误日志中可以看到路径被翻倍了（Desktop\demo出现了两次）：

resolve 'tailwindcss' in 'C:\Users\Administrator\Desktop\demo\Desktop\demo\my-project-test\src'

但本项目 CI 在windows-latest上运行ut build是通过的，说明这不是一个通用的 Turbopack Windows 问题。为了进一步定位，能否提供以下信息？

1. 你的Desktop目录是否开启了 OneDrive 同步？ Windows 上 OneDrive 粘贴桌面重定向为 junction/symlink，这可能导致路径解析异常
2. 换一个不在桌面下的目录（如现在C:\Projects\test）尝试是否还恢复？
3. **使用 Node.js v20（CI 使用的版本）是否能正常启动？**您的环境使用了 v24.0.1
4. 运行npm run build是否正常？ CI 运行的是构建，而你报告的是11npm start（dev 模式）

这些信息可以帮助缩小问题范围，判断是路径相关、节点版本相关还是开发模式特有的问题。

1. Desktop目录没有开启OneDrive 同步
2. 试过其他盘也会出现这种情况 但是有的时候他是正常的 但是下次运行 又会出现resolve 'tailwindcss'
3. 试过 v23.4.0 v24.0.1版本的node 也不正常启动
4. npm run build 试过也是会出现 resolve 'tailwindcss' 一模一样的情况

[LinAsan-1205]

#11749

@LinAsan-1205帮忙验证一下？
刚测试过了一下还是一样

[afc163]

@LinAsan-1205 我开了一个新的 PR #11757，从 enhanced-resolve 的缓存机制层面修复了这个问题。

根因分析：@tailwindcss/node 使用 enhanced-resolve + CachedInputFileSystem(4000ms) 解析 @import "tailwindcss"。Windows 上 Windows Defender 扫描 node_modules 时会导致文件系统 stat 临时失败，这个失败结果会被缓存 4 秒，期间所有解析都会失败——这就是间歇性出现的原因。

修复方式：在 postcss.config.js 中设置 globalThis.__tw_resolve，这是 Tailwind CSS v4 官方预留的自定义解析 hook，会优先于 enhanced-resolve 执行，改用 Node.js 原生的 require.resolve 来解析模块。

另外也修复了 @source "./src" → @source "."（路径相对于 CSS 文件本身，./src 会指向不存在的 src/src/）。

请在 Windows 11 环境下验证：

1. git checkout fix/tailwindcss-windows-resolve
2. npm start 多次启动，确认不再出现 Can't resolve 'tailwindcss'
3. npm run build 也能正常构建

[LinAsan-1205]

@LinAsan-1205我开了一个新的 PR #11757，从enhanced-resolve服务器机制方面修复了这个问题。

根本原因分析：@tailwindcss/node使用enhanced-resolve+CachedInputFileSystem(4000ms)解析@import "tailwindcss"。Windows上的Windows Defender扫描node_modules时会导致文件系统stat临时失败，这个失败结果会被缓存4秒，期间所有解析都会失败——这就是间歇性出现的原因。

修复方式：在postcss.config.js中设置globalThis.__tw_resolve，这是Tailwind CSS v4官方初始化的自定义解析hook，会优先于enhanced-resolve执行，改用Node.js原始的require.resolve来解析模块。

另外也修复了@source "./src"→ @source "."（路径相对于CSS文件本身，./src会指向不存在的src/src/）。

请在Windows 11环境下验证：

1. git checkout fix/tailwindcss-windows-resolve
2. npm start多次启动，确认不再出现Can't resolve 'tailwindcss'
3. npm run build也能正常构建

1. 其他盘路径下新拉取的 fix/tailwindcss-windows-resolve 分支的代码 多次启动npm start 正常
2. C盘新拉取的 fix/tailwindcss-windows-resolve 还是会出现 Can't resolve 'tailwindcss'
3. 在已有的代码里面 根据 fix/tailwindcss-windows-resolve 里面的修改后 还是会出现
   E:\work\node\admin\apps\backend-admin-view>npm start

ant-design-pro@6.0.0 start
cross-env APP_ENV=dev UMI_ENV=dev MOCK=none max dev
info - [你知道吗？] 遇到难解的配置问题，试试从 Umi FAQ 中寻找答案，详见 https://umijs.org/docs/introduce/faq
info - [plugin: ./node_modules/@umijs/plugins/dist/react-query] [reactQuery] use local package, version: 5.100.6
Using openapi Plugin
Error: Can't resolve 'tailwindcss' in 'E:\work\node\admin\apps\apps\backend-admin-view\src'
[at finishWithoutResolve (E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:909:18)]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:1001:14]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
[at eval (eval at create (E:\work\node\admin\apps\backend-admin-view\node_modules\tapable\lib\HookCodeFactory.js:31:10), :15:1)]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
[at eval (eval at create (E:\work\node\admin\apps\backend-admin-view\node_modules\tapable\lib\HookCodeFactory.js:31:10), :27:1)]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\DescriptionFilePlugin.js:97:43]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:1080:5]
[at eval (eval at create (E:\work\node\admin\apps\backend-admin-view\node_modules\tapable\lib\HookCodeFactory.js:31:10), :15:1)]
[at E:\work\node\admin\apps\backend-admin-view\node_modules\enhanced-resolve\lib\Resolver.js:1080:5] {
details: "resolve 'tailwindcss' in 'E:\work\node\admin\apps\apps\backend-admin-view\src'\n" +
' Parsed request is a module\n' +
' using description file: E:\work\node\admin\package.json (relative path: ./apps/apps/backend-admin-view/src)\n' +
' resolve as module\n' +
" E:\work\node\admin\apps\apps\backend-admin-view\src\node_modules doesn't exist or is not a directory\n" +
" E:\work\node\admin\apps\apps\backend-admin-view\node_modules doesn't exist or is not a directory\n" +
" E:\work\node\admin\apps\apps\node_modules doesn't exist or is not a directory\n" +
" E:\work\node\admin\apps\node_modules doesn't exist or is not a directory\n" +
' looking for modules in E:\work\node\admin\node_modules\n' +
' single file module\n' +
' using description file: E:\work\node\admin\package.json (relative path: ./node_modules/tailwindcss)\n' +
' no extension\n' +
" E:\work\node\admin\node_modules\tailwindcss doesn't exist\n" +
' .css\n' +
" E:\work\node\admin\node_modules\tailwindcss.css doesn't exist\n" +
" E:\work\node\admin\node_modules\tailwindcss doesn't exist\n" +
" E:\work\node\node_modules doesn't exist or is not a directory\n" +
" E:\work\node_modules doesn't exist or is not a directory\n" +
" E:\node_modules doesn't exist or is not a directory"
}
Error: Can't resolve 'tailwindcss' in 'E:\work\node\admin\apps\apps\backend-admin-view\src'

[afc163]

@LinAsan-1205 试一下最新的 utoo #11763 ，拉一下最新的 master 就好，看看 utooland/utoo#2891 是否已经被修复。

[LinAsan-1205]

@LinAsan-1205 试一下最新的 utoo #11763 ，拉一下最新的 master 就好，看看 utooland/utoo#2891 是否已经被修复。

可以正常运行了 但是有其他错误

[afc163]

重新拉下最新的 master 重装 node_modules 试试，如果还有这个问题，帮忙排查一下是哪里报错。把完整错误堆栈发上来看看。

[LinAsan-1205]

重新拉下最新的 master 重装 node_modules 试试，如果还有这个问题，帮忙排查一下是哪里报错。把完整错误堆栈发上来看看。

刚试了一下还是一样

C:\Users\Administrator\Desktop\demo\ant-design-pro>npm start

ant-design-pro@6.0.1 start
cross-env UMI_ENV=dev max dev

info - [你知道吗？] father 4 正式发布了，详见 https://zhuanlan.zhihu.com/p/558192063
info - [plugin: ./node_modules/@umijs/plugins/dist/react-query] [reactQuery] use local package, version: 5.100.9
Using openapi Plugin

utoo pack v1.4.3 ready in 10912ms

➜ Local: http://localhost:8002
➜ Network: http://198.18.0.1:8002
Persisting failed: Unable to commit operations

Caused by:
拒绝访问。 (os error 5)
Persisting is disabled for this session due to an unrecoverable error. Stopping the background persisting process.

然后访问网页 http://localhost:8002 提示以下

Uncaught (in promise) TypeError: Cannot read properties of null (reading 'applyPlugins')
at getAntdConfig (runtime.tsx:18:39)
at innerProvider (runtime.tsx:97:7)
at plugin.js:143:24
at Array.reduce ()
at PluginManager.applyPlugins (plugin.js:140:26)
at getBrowser (browser.js:114:40)
at renderClient (browser.js:249:17)
at initialValue (umi.ts:73:26)
at plugin.js:198:13
at render (umi.ts:75:3)