Astro 命令使用完全指南
Astro 命令使用指南 本文基于 Astro 4.x 稳定版 整理，覆盖从项目创建、开发调试、生产构建到工具运维的全流程命令，包含参数详解、使用示例、场景速查与常见避坑指南。 一、前置说明 1. 命令执行方式 Astro 命令有两种执行方式： 项目内执行：通过 package.json 脚本调用（推荐），格式为 npm run <脚本名> 直接调用：通过包管理器执行原生 Astro 命令，格式为 npx astro <子命令>（pnpm/yarn/bun 对应写法见下文） 2. 传参规则 通过 npm run 执行脚本时，额外参数必须用 -- 分隔，否则参数会被 npm 自身捕获而非传给 Astro。 # 正确写法 npm run dev -- --port 3000 # 错误写法（参数不生效） npm run dev --port 3000 pnpm/yarn/bun 兼容上述写法，也支持直接传参（如 pnpm dev --port 3000）。 3. 不同包管理器命令对照表 功能 npm pnpm yarn bun 创建项目 npm create astro@latest pnpm create astro yarn create astro bun create astro 启动开发服务 npm run dev pnpm dev yarn dev bun dev 生产构建 npm run build pnpm build yarn build bun build 预览构建产物 npm run preview pnpm preview yarn preview bun preview 执行原生命令 npx astro <子命令> pnpm astro <子命令> yarn astro <子命令> bunx astro <子命令> 4. 全局通用参数 所有 Astro 子命令都支持以下基础参数： ...