webstorm 本身不提供项目部署功能，它只是 ide；所谓“部署”，实际依赖外部工具链（如 npm script、ssh、docker 或 ci/cd 工具），webstorm 只负责触发和集成。
WebStorm 里怎么配 npm run build？
多数前端项目靠 npm run build 生成静态资源，WebStorm 可以一键运行但需确认两件事：
-
package.json中存在"build"脚本，且指向正确命令（比如"vite build"或"webpack --mode production"） - 终端工作目录是项目根路径——右键项目根目录 → Open in Terminal，避免在子目录下误执行
- 若提示
command not found: vite，说明本地没装全局vite，应改用npx vite build或确保node_modules/.bin在 PATH 中
为什么 WebStorm 的 Node.js 运行配置总报错 “Cannot find module”？
常见于新建项目后首次运行脚本，本质是 Node.js 解析路径或模块解析失败：
- 检查
Node interpreter设置：File → Settings → Languages & Frameworks → Node.js and NPM → Node interpreter，必须指向真实存在的node可执行文件（不是 alias 或 shell function） - 确认
package.json中的"type": "module"和require()混用会直接崩溃——ESM 项目请统一用import - 如果用了
ts-node，需额外安装@types/node并在tsconfig.json中启用"moduleResolution": "node"
如何让 WebStorm 自动识别 .env 文件里的变量？
WebStorm 不自动加载 .env，环境变量需显式注入：
- 运行配置 → Environment variables 栏手动添加，例如
NODE_ENV=production；不要指望它读取.env文件内容 - 若用
dotenv，确保代码中已调用require('dotenv').config()，否则 WebStorm 即使识别了文件也无实际作用 -
.env.local会被create-react-app优先读取，但 WebStorm 不做特殊处理——它只当普通文本文件，变量生效与否完全取决于运行时逻辑
真正卡住人的往往不是 WebStorm 设置，而是 node_modules 是否完整、lockfile 是否匹配、以及不同 shell（zsh/bash）下 PATH 的差异——建议始终在 WebStorm 内置终端执行 which node 和 npm ls vite 验证上下文。
