Astro 命令使用完全指南

Fri, 19 Jun 2026 22:33:20 +0800

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 命令使用完全指南

Fri, 19 Jun 2026 22:33:20 +0800

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 站点项目，生成标准的目录结构。

静态站点生成器 on Meng Blog