命令行工具

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 子命令都支持以下基础参数： ...

Hugo 命令使用指南 Hugo 是基于 Go 语言开发的静态站点生成器，所有核心能力都可以通过命令行完成调用。本指南按使用场景分类，覆盖从项目初始化、本地开发、内容管理到生产构建的全流程命令，并附带参数说明、使用示例和最佳实践。 一、基础命令：帮助与版本查询 1. hugo help 查看 Hugo 所有命令的总览，也可以在任意子命令后加 --help 查看该命令的详细参数。 # 查看所有命令总览 hugo help # 查看 server 子命令的详细参数 hugo server --help # 简写 hugo server -h 2. hugo version 查看当前安装的 Hugo 版本、操作系统架构、Go 版本信息，常用于排查兼容性问题。 hugo version # 输出示例：hugo v0.128.0+extended linux/amd64 BuildDate=... 注意：带 extended 标识为扩展版，支持 Sass/SCSS 编译；多数主题需要扩展版才能正常构建。 3. hugo env 打印完整的 Hugo 运行环境信息，包括版本、配置路径、环境变量、模块缓存路径等，排查构建问题时常用。 hugo env 二、项目初始化与主题管理 1. hugo new site 创建一个全新的 Hugo 站点项目，生成标准的目录结构。 ...