---
title: "安装 Dart 和 Flutter 插件"
summary: "从 flutter/agent-plugins 安装 dart-flutter@dart-flutter，包含技能和 dart-mcp-server。项目规则需单独添加，本机需安装 Dart / Flutter SDK。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Flutter", "Dart", "MCP", "dart-flutter@dart-flutter"]
canonical: /tips/dart-flutter-codex-plugin/
---

# 安装 Dart 和 Flutter 插件

从 flutter/agent-plugins 安装 dart-flutter@dart-flutter，包含技能和 dart-mcp-server。项目规则需单独添加，本机需安装 Dart / Flutter SDK。

从 flutter/agent-plugins 安装 dart-flutter@dart-flutter，包含技能和 dart-mcp-server。项目规则需单独添加，本机需安装 Dart / Flutter SDK。

这是 [Flutter 官方 AI 入门](https://docs.flutter.dev/ai/get-started) 的 Codex 专节，不是 Claude 的 `claude plugin install dart-flutter@dart-flutter`，不是 Cursor 的 `/add-plugin dart-flutter`，也不是 Gemini CLI 的 `gemini extensions install https://github.com/gemini-cli-extensions/flutter`。官方 Codex 主路径是 Flutter 团队的 `plugin add`。

本机要有 **Dart / Flutter SDK**（`dart` 在 PATH），现行 Codex 能跑 `plugin marketplace add`。清单 `.agents/plugins/marketplace.json` 的 name 是 `dart-flutter`，插件 name 也是 `dart-flutter`（`plugin.json` 1.0.4）：

```bash
codex --version
which dart
codex plugin marketplace add flutter/agent-plugins
codex plugin add dart-flutter@dart-flutter
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

插件会登记一台 **stdio** MCP，表名是 `dart-mcp-server`（不是手写 JSON 里常见的 `dart`）。command 是 `dart`，args 是 `mcp-server`。**不要** `codex mcp login dart-mcp-server`。插件已经带 MCP 时，不要再 `codex mcp add dart -- dart mcp-server` 叠一张用户层表。这台是分析器、测试、pub、热重载和 Widget Inspector，靠 Dart Tooling Daemon；跑 Flutter 用 debug / profile，不要 `--no-dds`。纯 Dart 才加 `--observe`。

官方写明：插件会装技能和 MCP，**不会**自动带上规则。要把 `flutter/agent-plugins` 的 `.md` 规则拷进项目 `.agent/rules/`，或追加到 `CODEX.md`。不要指望 `AGENTS.md` 会自己出现这些规则。

可选：`codex plugin marketplace upgrade dart-flutter` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `dart-mcp-server`。连接失败先看 `which dart`，以及当前工程是不是 Flutter / Dart 根。热重载会更新运行中的应用界面，保持工具批准。保持工具调用审批。

## 来源

- [Flutter · Get started developing with AI](https://docs.flutter.dev/ai/get-started)
- [flutter/agent-plugins](https://github.com/flutter/agent-plugins)
- [dart-lang/ai · dart_mcp_server](https://github.com/dart-lang/ai/tree/main/pkgs/dart_mcp_server)