---
title: "安装"
description: "在现有的 Nuxt 项目中安装 Nuxt Scripts。"
canonical_url: "https://nuxt-scripts.zhcndoc.com/docs/getting-started/installation"
last_updated: "2026-08-11T09:33:07.370Z"
---

## 快速开始

Nuxt Scripts 2 需要 [Node.js](https://nodejs.org) 24 或更高版本、Nuxt 4.5.1 或
更高版本（包括 Nuxt 5），以及 `Unhead >=3.3.1 <4`。在安装前升级现有项目：

```bash
npx nuxi@latest upgrade --force
```

运行：

```bash
npx nuxi@latest module add scripts
```

> <span>
> 
> !TIP
> 
> </span>
> 
> 
> 使用 [skilld](https://github.com/skilld-dev/skilld) 为此软件包生成代理技能：
> 
> ```bash
> npx skilld add @nuxt/scripts
> ```

[Nuxt 模块命令](https://nuxt.com/docs/api/commands/module) 会安装 Nuxt Scripts，并将其添加到 Nuxt 配置中的 `modules` 数组。

## 下一步

接下来，选择最符合你需求的指南：

1. 使用 [Confetti 教程](/docs/getting-started/confetti-tutorial) 构建一个小型集成。
2. 在 [脚本触发器](/docs/guides/script-triggers) 中了解脚本何时加载。
3. 在 [脚本注册表](/scripts) 中查找预配置的集成。
4. 使用 [`useScript()`](/docs/api/use-script) 或 [全局脚本](/docs/guides/global) 加载未列出的脚本。
5. 配置 [第一方模式](/docs/guides/first-party) 或 [同意管理](/docs/guides/consent)。