必须全局安装（npm install -g netlify-cli），否则vscode终端中netlify命令报“command not found”；需在项目根目录运行netlify init绑定站点，并确保已执行npm run build生成正确输出目录。
netlify-cli 安装必须用 -g，否则 netlify 命令不可用
在 VSCode 终端里执行 npm install netlify-cli（没加 -g）后，netlify 命令会报 “command not found”。这是因为 CLI 工具需要全局注册才能被系统识别。
正确做法是：
- 先确认 Node.js 和 npm 已就绪：
node -v和npm -v有输出 - 运行
npm install -g netlify-cli（注意-g） - 重启 VSCode 终端，或运行
source ~/.zshrc（macOS/Linux）或重开 PowerShell（Windows）让 PATH 生效 - 验证：
netlify --version应返回版本号，如13.9.2
项目根目录下运行 netlify init 才能绑定站点
netlify init 不是“随便在哪都能跑”的命令——它必须在你前端项目的根目录（即含 package.json、netlify.toml 或构建脚本的目录）中执行，否则会提示 No site configuration found 或直接创建一个空站点。
常见误操作：
- 在 VSCode 工作区父文件夹下运行 → 绑定失败，后续
deploy报找不到 build 命令 - 未登录就运行 → 提示
not logged in，需先netlify login - 选错框架类型（比如选了 “Create & configure a new site” 而非 “Configure and deploy an existing site”）→ 生成冗余配置，build 命令可能被覆盖为默认值
建议：执行前先 pwd 确认路径，再 ls -la 检查是否存在 package.json 和 build 脚本。
netlify dev 启动本地预览时，必须匹配真实构建逻辑
netlify dev 不是简单起个 localhost:8888 就完事。它会尝试读取 netlify.toml 中的 [dev] 配置，或自动探测框架（如 Next.js 用 next dev，Vue 用 vue-cli-service serve）。若探测失败，就会 fallback 到静态服务器，导致路由 404、API 代理失效、环境变量不加载。
解决办法：
- 显式指定启动命令：
netlify dev --command "npm run dev"（对应package.json中的"dev"脚本） - 手动写
netlify.toml，例如 Vue 项目：[dev] command = "npm run serve" port = 8080 publish = "dist"
- 确保
dev脚本启动的是开发服务器，不是构建命令（别写成"dev": "npm run build"）
netlify deploy 失败最常卡在输出目录和权限
执行 netlify deploy --prod 后卡住、报错或部署了空页面，90% 是因为输出目录不对或没生成。
关键检查点：
- 是否已手动运行过构建？
npm run build必须成功执行，并生成目标目录（如dist、.next、out） - 目录名是否拼写一致？
netlify init过程中填的 “publish directory” 必须和实际构建产物路径完全一致（区分大小写，不带尾部斜杠） - 是否误把
src或public当作输出目录？这些是源码目录，不是构建产物 - Windows 用户注意路径分隔符：VSCode 终端用
\或/都行，但netlify.toml中统一用/（如publish = "dist"）
临时验证方式：执行 ls -la dist（或对应目录），确认里面有 index.html 和静态资源。
Netlify 的自动构建流程看似零配置，但 CLI 部署依赖三个硬性前提：全局命令可用、项目路径准确、输出目录真实存在且可读——漏掉任一环，都会在 deploy 或 dev 阶段静默失败，而不是报明确错误。
