VS Code提示“未检测到工作区”是因缺少package.json或依赖未安装；需检查根目录文件、安装依赖、核对Node版本、确认scripts命令、查看终端实际地址及配置语言服务插件。
打开项目文件夹时 VS Code 提示“未检测到工作区”
VS Code 本身不自动识别前端项目类型，它只认文件夹结构和配置文件。如果你直接 File → Open Folder 进去，但没看到终端自动启动、没有智能提示、npm run dev 报错，大概率是项目依赖没装或环境没配好。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 先确认项目根目录下有
package.json—— 没这个文件，就不是标准 npm 项目，别硬按前端流程走 - 打开集成终端（
Ctrl+`），手动执行npm install或yarn install；如果卡在 node-gyp 或 python 错误，说明本地 Node.js 版本和项目要求不匹配 - 某些项目（比如用 pnpm 的）会写明需要
pnpm install，看README.md里setup或getting started小节，别跳过
运行 npm run dev 报错 “command not found” 或 “missing script”
这不是 VS Code 的问题，而是脚本名不统一导致的。不同框架默认开发命令不一样，package.json 里的 "scripts" 字段才是关键入口。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 打开
package.json，找"scripts"对象，常见开发命令包括："dev"、"start"、"serve"、"watch"，甚至可能是"storybook"或"vite" - 如果只有
"build"没有开发命令，说明这项目可能没提供热更新服务，只能构建后手动开浏览器看dist/index.html - 遇到
cross-env、concurrently等工具报错，先npm install -D cross-env装上再试，别直接删脚本
终端跑起来了但页面空白 / 404 / localhost 打不开
前端开发服务器通常绑定 localhost:3000 或 localhost:5173，但端口被占、代理配置错、或路径别名没生效都会导致白屏。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 看终端输出的第一行——真正生效的地址是它写的那个，不是你凭经验猜的；比如 Vite 会写
Local: http://localhost:5173/，而 Create React App 是http://localhost:3000 - 如果提示
Something is already running on port XXXX，要么关掉其他程序，要么在启动命令后加端口参数：如npm run dev -- --port 3001 - 部分项目（尤其老 Vue CLI）依赖
vue.config.js里的devServer.public或proxy配置，改错会导致 API 请求 404，但页面本身能出来
代码没报错但编辑器里全是红色波浪线（TS 类型/ESLint 报错）
这是 VS Code 没加载对应语言服务，不是项目本身有问题。TypeScript 和 ESLint 都需要插件 + 工作区配置才能联动。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保已安装官方插件：
ESLint、TypeScript and JavaScript Language Features（内置，但可能被禁用） - 检查项目是否有
tsconfig.json或jsconfig.json；没有的话，TS 类型检查基本失效，波浪线只是语法高亮误判 - 如果用了 Prettier + ESLint 组合，注意
.eslintrc.cjs里是否写了root: true，否则 VS Code 可能读不到规则
最常被忽略的一点：很多“别人写的项目”其实依赖特定的 Node.js 版本（比如 .nvmrc 或 .node-version 文件里锁了 v18.17.0），用 v20 直接跑会触发 ERR_MODULE_NOT_FOUND 或 exports is not defined。别急着重装依赖，先 nvm use 切对版本再说。
