一、AI IDE 概述
1.1 什么是 AI IDE？
AI IDE（Artificial Intelligence Integrated Development Environment，人工智能集成开发环境）是在传统 IDE 基础上深度融合大语言模型（LLM）与代码智能体技术的新一代编程工具。
它不仅具备代码编辑、语法高亮、编译调试等基础开发功能，更能「理解开发者的自然语言意图」，主动生成代码、修复 Bug、解释逻辑、撰写单元测试，甚至以「智能体」模式自主执行多步骤复杂研发任务。
1.2 AI IDE 的发展背景
近年来软件开发面临以下三大核心挑战：
● 项目复杂度持续攀升------代码规模动辄数百万行，手工维护成本极高，技术债务不断累积；
● 交付周期不断压缩------敏捷与 DevOps 要求研发节奏越来越快，人效瓶颈日益突出；
● 代码质量标准越来越严------安全漏洞、合规问题、开源风险难以依靠人工完全规避。
在此背景下，以 GitHub Copilot、Cursor、通义灵码、华为云码道等为代表的 AI IDE 与 AI 编码助手相继涌现，标志着软件开发正在从「人工编码」迈向「AI 辅助编码」乃至「AI 自主编码」的全新范式。
1.3 AI IDE 核心能力矩阵
1.4 AI IDE 与传统 IDE 的对比
二、华为云码道（CodeArts）简介
2.1 产品定位与核心理念
官方定义：华为云码道（CodeArts）代码智能体是华为云打造的智能编码产品，深度融合 IDE、自主开发模式与代码大模型能力，支持项目级代码生成、代码续写、研发知识问答、单元测试用例生成等核心功能，可高效提升开发者研发效率，带来优质的智能化编码体验。
「码道」二字寓意「驭码载道」------
●「码」：代码，软件的核心载体；
●「道」：研发之道，华为二十余年工程化实践与技术智慧的结晶。
码道的目标是打造一个「理解项目需求、懂得编码之道、善用百器」的实干派 AI 研发专家，真正开启开发者的「编码自动驾驶模式」。官网对常见问题解答，如下：
2.2 产品发展历程
2.3 技术底座
● 依托华为 20+ 年研发实践经验与千亿行代码沉淀，形成强大的工程化知识积累；
● 集成业界领先开源模型：GLM-5.0（智谱 AI）、DeepSeek-V3.2（深度求索）；
● 提供华为自研模型，基于海量研发数据增训与强化学习；
● 专为鸿蒙（HarmonyOS ArkTS）和昇腾（Ascend）生态提供专属优化模型；
● 支持自定义第三方模型接入，满足企业私有化部署需求。
2.4 产品三大核心支柱
三、CodeArts 官方网址与第三方学习资源
3.1 官方核心网址
▸ 产品主页与下载
🔗 华为云码道官网（首页） --- 产品介绍、最新特性、免费下载入口
https://codearts.huaweicloud.com/index.html
🔗 产品下载页（所有平台安装包） --- IDE、VS Code 插件、JetBrains 插件等
https://codearts.huaweicloud.com/download.html
🔗 华为云产品详情页（含 FAQ） --- 官方功能说明与常见问题解答
https://codearts.huaweicloud.com/
▸ 官方文档中心
🔗 快速入门 --- 华为云码道 AI IDE --- 官方 Step-by-Step 安装教程
https://support.huaweicloud.com/qs-codeartssnap/codeartsdoer_qs_0001.html
🔗 快速入门 --- IntelliJ IDEA 插件版 --- UT 智能体实战演示
https://support.huaweicloud.com/qs-codeartssnap/codeartsdoer_qs_0003.html
🔗 华为云技术支持文档中心 --- 全产品线文档检索入口
https://support.huaweicloud.com/
▸ 社区与反馈
🔗 华为云开发者社区（论坛 / 博客） --- 官方技术文章与用户实战分享
🔗 建议反馈（云声） --- 向华为云官方反馈问题与建议
https://bbs.huaweicloud.com/suggestion
3.2 学习建议
建议先从官方快速入门文档开始，完成官方案例实战后，再结合华为云开发者社区的实战文章深入学习各垂直场景（鸿蒙开发、昇腾 AI、Java 企业开发等）。
四、CodeArts 安装与使用
4.1 安装前准备
4.2 方式一：安装华为云码道 AI IDE（独立客户端）
ℹ️ 适用场景
推荐首次体验用户，或希望获得完整 AI 原生 IDE 体验的开发者。无需已有 IDE 基础，开箱即用。
▸ 步骤 1 --- 下载安装包
1.访问官网下载页：https://codearts.huaweicloud.com/download.html
2.在「华为云码道 IDE」区域，点击「免费下载」获取安装程序。
▸ 步骤 2 --- 执行安装
3.安装程序文件，根据界面提示完成安装。
4.安装完成后，点击出现的「华为云码道」图标。
▸ 步骤 3 --- 首次启动与登录
5.双击桌面图标启动 IDE，进入欢迎页面。
6.点击「开始」，进入配置导入页面。
7.选择「从 VS Code 导入」（迁移已有项目配置）或「跳过」------新用户直接跳过即可。
8.进入华为云账号登录页，输入账号密码完成登录。
9.首次登录自动进入服务开通页，勾选「我已阅读并同意」，点击「立即开通」。
10.套餐开通完成，页面提示「登录成功」后，即可在 IDE 中开始智能编码之旅。
4.3 方式二：VS Code 插件安装
ℹ️ 适用场景
已熟悉并使用 Visual Studio Code 的开发者，可在现有 VS Code 环境中无缝集成 AI 能力，无需切换工具。
▸ 在线安装（推荐）
11.确保已安装最新版 Visual Studio Code。
12.访问下载页 https://codearts.huaweicloud.com/download.html，点击「安装插件」按钮，直接唤起 VS Code 插件市场。
13.或手动打开 VS Code → 扩展（Ctrl+Shift+X）→ 搜索「CodeArts Agent」→ 点击「安装」。
14.安装完成后重启 VS Code，点击侧边栏华为云码道图标，登录华为云账号即可使用。
▸ 离线安装
15.在下载页选择对应版本的 .vsix 离线安装包下载到本地。
16.VS Code 中：扩展 → 右上角「···」→「从 VSIX 安装」→ 选择下载的文件。
17.安装完成后重启 VS Code，登录账号即可。
4.4 方式三：JetBrains 系列插件（以 IntelliJ IDEA 为例）
ℹ️ 适用场景
使用 JetBrains 全家桶（IntelliJ IDEA / PyCharm / GoLand / WebStorm 等）的开发者，支持在线与离线两种安装方式。
▸ 在线安装（推荐）
18.双击启动已安装的 IntelliJ IDEA。
19.进入 File → Settings（Ctrl+Alt+S）→ 左侧菜单选择「插件（Plugins）」→ 点击「Marketplace」。
20.搜索框输入「CodeArts Agent」→ 在搜索结果中点击「安装（Install）」。
21.安装完成后点击「重启 IDE」使插件生效。
22.重启后，在 IntelliJ IDEA 侧边栏可见华为云码道插件图标，登录华为云账号完成开通。
▸ 离线安装
23.前往下载页，根据 IDEA 版本下载对应的 .zip 离线安装包。
24.IDEA 中：Settings → Plugins → 齿轮图标 → Install Plugin from Disk → 选择文件。
25.重启 IDE 后登录账号即可。
4.5 支持的开发环境总览
五、CodeArts 使用示例
示例一：用自然语言从零构建 TodoList Web 应用
ℹ️ 场景说明
通过一句自然语言描述，码道自动生成完整的 Web 应用代码（HTML + CSS + JavaScript），全程无需手动编写一行代码。
▸ 操作步骤
26.在华为云码道 IDE 中新建文件夹，命名为 TodoApp。
27.在右侧对话框中输入以下指令：
在 TodoApp 文件夹下实现一个 TodoList 的 Web 应用，
要求生成的界面简洁、美观、易用，针对待办应用的基础功能齐全，
包含新增、删除、标记完成、清除已完成等功能。28.码道智能体自动分析需求，生成 index.html、style.css、app.js 等完整文件。
29.在「资源管理器」中右键 index.html → 选择「打开预览」，在内置浏览器中实时查看效果。
30.可在对话框中继续追加需求（如「增加本地 localStorage 持久化存储」），码道自动修改代码。
💡 效果说明
码道生成的 Web 应用可直接在浏览器中运行，所有增删改查功能均可正常验证。这正是「项目级代码生成」的典型体现------从需求到可运行代码，一步到位。
示例二：UT 智能体自动生成单元测试（IntelliJ IDEA）
ℹ️ 场景说明
在 Java 项目中，对已有核心方法使用 UT 智能体一键生成单元测试用例，快速提升代码测试覆盖率。
▸ 前置条件
● 已安装 IntelliJ IDEA 并完成 CodeArts Agent 插件安装。
● 项目构建系统必须为 Maven（pom.xml 必须存在）。
▸ 操作步骤
31.在 IntelliJ IDEA 中打开目标 Java 项目。
32.在华为云码道聊天界面中，将模型切换为「UT 智能体」。
33.在目标代码文件中，选中需要测试的方法，右键选择「CodeArts 代码智能体 > 单元测试（智能体）」。
34.UT 智能体自动分析方法逻辑、输入参数、返回类型，生成完整 JUnit 测试类。
35.一键运行生成的测试用例，查看测试结果与覆盖率报告。
⚠️ 注意：若需要开启「自动批准」模式（无需每步确认），可在智能体设置 → UT 智能体 → 自动批准中手动开启，生产环境建议谨慎使用。
示例三：研发知识问答
ℹ️ 场景说明
在编码过程中遇到技术问题，直接在 IDE 内向码道提问，获得专业的技术解答，无需切换浏览器查文档。
你可以直接在对话框中输入以下类型的问题：
Q: Spring Boot 项目如何优雅地处理全局异常？
Q: Python 中如何实现线程安全的单例模式？
Q: HarmonyOS ArkTS 中如何声明响应式状态变量？
Q: 如何用 Redis 实现分布式锁？
Q: 请解释这段 Go 代码的执行逻辑...码道结合华为内部研发规范与千亿行代码经验，给出准确、完整的技术答案，并可直接将生成代码插入编辑器，真正实现「即问即用」。
示例四：鸿蒙 ArkTS 应用开发
ℹ️ 场景说明
华为码道提供鸿蒙（HarmonyOS）专属优化模型，对 ArkTS 语言的代码生成精准度远高于通用大模型，大幅降低鸿蒙开发门槛。
▸ 操作步骤
36.在码道 IDE 中选择「HarmonyOS」项目模板，系统自动配置 ArkTS 开发环境。
37.在对话框中描述功能需求，例如：
创建一个 ArkTS 页面，实现用户信息卡片组件：
包含头像（圆形）、用户名、签名、关注/粉丝数量展示，
点击「关注」按钮后切换为「已关注」状态并改变按钮颜色。38.码道生成符合鸿蒙官方 ArkTS 规范的完整组件代码。
39.可直接在 DevEco Studio 中运行预览效果，或由码道继续完善交互逻辑。
六、CodeArts 核心功能详解
6.1 项目级代码生成
码道的代码生成能力不止于函数级别的片段补全，而是真正实现「项目级」代码生成------理解整个项目的架构、技术栈、模块关系，跨文件生成完整的功能模块。
● 支持语言：Java、Python、JavaScript、TypeScript、Go、C/C++、Rust、HarmonyOS ArkTS 等主流语言；
● 支持框架：Spring Boot、Django、FastAPI、React、Vue、Flutter 等主流框架；
● 生成粒度：从单行代码到完整项目骨架，可精细控制生成范围；
● 上下文感知：结合 Codebase 索引，自动复用项目中已有的工具类和公共方法，避免重复造轮子。
6.2 智能代码续写（Code Completion）
在编辑器中实时触发，预测并补全下一行乃至多行代码。码道的 AI 续写（标记为 ⊕ 图标）基于项目全局上下文，建议更加精准：
● 基于当前光标位置的上下文，预测开发者的编写意图；
● 支持多行续写，一次生成完整的逻辑块；
● 可通过 Tab 键一键接受建议，Esc 忽略；
● 补全候选列表同时包含语言服务的静态补全与 AI 动态补全，可按需选择。
6.3 Codebase 代码库深度索引
Codebase 是码道区别于其他 AI 编码工具的核心差异化能力之一，也是「项目级」智能的技术底座。
6.4 专家技能（Skills）
Skills 是码道突破「AI 仅能思考」边界的关键------让 AI 从「说说而已」变成「真正执行」，产生实际的研发效果。
内置华为 20+ 年高频研发场景技能，覆盖研发全生命周期：
此外，开发者或企业可快速添加自定义技能，将团队特有的研发规范、最佳实践封装为 Skill，让 AI 自动遵守执行。
6.5 规范驱动开发（Spec-Driven Development）
码道将企业研发规范内化为 AI 的「行动准则」，从代码生成的源头保证质量，而非事后检查。
● 边聊边做：在对话开头约定编码规范（命名规范、架构规范、注释要求、安全规范），码道生成时自动遵守；
● 精准交付：减少因规范理解偏差导致的反复返工，降低 Code Review 负担；
● 代码尽在掌握：所有生成结果均可审查、可追溯、可修订；
● 企业级适配：支持将团队规范文档上传为自定义 Skill，持久化规范约束。
6.6 单元测试自动生成（UT Agent）
● 在对话框切换至「UT 智能体」模式，或右键代码选择「单元测试（智能体）」；
● 支持 JUnit（Java）、pytest（Python）、Jest（JavaScript/TypeScript）等主流测试框架；
● 生成的测试用例覆盖：正常路径、边界条件（空值、极值、超限）、异常场景（抛出异常）；
● 支持「自动批准」模式，可全自动完成测试用例生成、运行、结果分析的完整闭环。
6.7 多模型支持
6.8 数据安全与隐私保护
ℹ️ 华为的承诺
华为云码道非常重视用户的隐私和数据安全，代码数据仅用于当次交互，不会被存储在服务器或任何存储介质中。
6.9 智能体扩展架构（四层能力体系）
七、使用技巧与最佳实践
7.1 Prompt 工程技巧
▸ 技巧 1 --- 描述要具体、带上技术上下文
❌ 不好的 Prompt（过于笼统，AI 无从下手）：
写一个用户登录功能✅ 好的 Prompt（清晰、具体、带技术约束）：
使用 Spring Boot 3.x + Spring Security + JWT 实现用户登录接口：
- 接收 JSON 格式的 username 和 password
- 验证用户存在于 MySQL 的 users 表（username 字段唯一索引）
- 密码使用 BCrypt 加密存储
- 登录成功返回 JWT Token，有效期 24 小时
- 登录失败返回标准错误码（401）和描述信息
- 请同时生成对应的 UserController、UserService、UserRepository▸ 技巧 2 --- 拆分复杂任务，分步推进
对于大型功能，建议按层次逐步推进，每步确认后再进行下一步：
● 第一步：让码道生成数据库设计（建表 SQL + 实体类）；
● 第二步：基于实体类生成 Repository / DAO 层；
● 第三步：生成 Service 业务逻辑层；
● 第四步：生成 Controller 接口层；
● 第五步：生成单元测试和接口文档。
💡 为什么要分步？
分步推进可以让每一层的代码都得到确认，避免最终整体出错时难以定位问题，同时也让 AI 的每次生成更聚焦、上下文更清晰，质量更高。
▸ 技巧 3 --- 用 @ 引用精准上下文
在对话框中使用 @文件名 或 @类名 明确指定相关代码，让码道精准理解当前任务的范围：
参考 @UserService.java 的实现风格，
为 @OrderService.java 添加「查询订单列表」方法，
要求分页查询，返回 PageResult<OrderDTO>。7.2 Codebase 索引最佳实践
● 首次使用时：确保对整个项目完成 Codebase 索引，等待索引完成（可在状态栏查看进度）再发起请求；
● 大量代码变更后：主动触发重新索引，保持 AI 对项目的理解是最新的；
● 大型单体仓库：在「添加上下文」中手动指定最相关的模块路径，避免检索范围过广；
● 微服务架构：建议以单个服务为单位建立 Codebase，而不是索引整个 monorepo。
7.3 规范驱动最佳实践
●「约法三章」在先：每次新项目开始时，在对话开头明确说明技术栈、命名规范、注释要求、禁用函数等约束；
● 将团队规范沉淀为 Skill：把团队编码规范、架构规范文档上传为自定义 Skill，后续所有生成自动遵守，无需每次重复说明；
● Review 即反馈：发现生成代码不符合规范时，直接在对话中指出，码道会自动调整并记住这次反馈。
7.4 模型选择建议
7.5 网络环境配置
▸ 企业内网代理配置
40.在码道 IDE 中打开：文件 → 首选项 → 设置 → 搜索「proxy」。
41.在「Http: Proxy」中填入企业代理地址，如 http://xxx.com。
42.重启 IDE 后生效。
▸ 登录失败应急处理
● 方法一：打开命令提示符（管理员），执行 netsh winsock reset，重启电脑后重试。
● 方法二：检查杀毒软件/防火墙是否拦截了 codearts.huaweicloud.com 的连接，添加白名单。
● 方法三：参考官方文档「登录常见问题」章节获取最新解决方案。
7.6 团队协作与管理建议
● 版本统一：全团队使用相同版本的码道插件，避免因版本差异导致行为不一致；
● 规范共享：将 Skills 配置、规范文档、高效 Prompt 模板纳入 Git 版本控制，团队成员共享；
● Review 规范：制定「AI 生成代码 Review 规范」，所有 AI 生成代码必须经人工 Review 后才能合入主干；
● 知识沉淀：定期组织团队 Prompt 分享会，沉淀高效提示词，形成团队专属 Prompt 知识库；
● 安全意识：不要将涉密代码、密钥、密码等敏感信息作为上下文传入 AI，养成良好的信息安全习惯。
没有自由的秩序和没有秩序的自由，同样具有破坏性。
