安装 Junie 并用 .junie 指南文件规范它的工作方式

Junie 是 JetBrains 推出的智能体式编程插件，它和普通的代码补全不同：你把一个需求交给它，它会自己规划执行步骤，然后逐步把任务做完。它除了能读取项目的静态索引，还能读取 IDE 中当前代码静态检查的结果，例如 Problems 窗口里报出的问题，可以直接交给它去修。这篇教程面向第一次接触 Junie 的开发者，讲清三件事：怎么确认自己有没有使用资格、怎么在 IDE 里装好并打开它、以及怎么用项目根目录下的 .junie 指南文件把它的行为约束到你想要的样子。如果你只是想先了解这个工具的整体定位，可以先看 Junie 的工具页，再回到本文动手。

准备工作

确认 IDE 与操作系统

Junie 以插件形式发布，目前支持 IntelliJ IDEA、PyCharm、WebStorm 三款 IDE；GoLand 处于内测阶段，其他 IDE 的支持仍在开发中。操作系统方面，Windows、macOS、Linux 上的 IDE 都可以使用。动手之前先确认你日常用的 IDE 在支持列表里，否则装完插件也不会出现可用的工具窗口。

确认许可证状态

Junie 需要先获得使用资格。拿到资格之后，不要急着装插件，先去 JetBrains Account 的许可证页面核对一下 Junie 的许可证状态是否正常。这一步容易被跳过，但许可证没生效时，插件装上了也用不起来。关于资格如何申请、当前开放到哪些地区、是否收费，这些信息会变化，请以官网当前信息为准。

准备一个可用的项目

建议拿一个真实的小项目来试，而不是空目录。Junie 的价值很大一部分来自它能读取项目上下文，项目越真实，它规划出的步骤越贴近实际。同时确认项目已经纳入版本控制（VCS），后面共享指南文件会用到。

操作步骤

第一步：在插件市场安装 Junie

在 IDE 中打开插件市场，搜索 Junie 并安装。安装完成后重启 IDE，即可在侧边打开 Junie 工具窗口。工具窗口是后续所有交互的入口：你在这里输入需求、查看它规划出的步骤、在它执行过程中插话纠正。

第二步：把需求交给 Junie，让它自己规划

使用时不需要你先把任务拆成小步。直接把需求描述清楚交给 Junie，它会自动规划需求的执行步骤，然后逐步完成任务。因为任务是分步执行的，你可以在接续的聊天中针对某一步指出错误，要求它修正——这比一次性丢一个巨大的需求、最后只看到一个错误结果要好排查得多。

一个实用的切入点是 Problems 窗口。IDE 的静态检查已经帮你定位了问题所在，把这些报错直接交给 Junie 修复，上下文清晰、范围可控，很适合作为第一次试用的任务。

第三步：了解 Brave Mode 的取舍

默认情况下，Junie 需要在终端执行命令时会先请求你的许可。如果启用 Brave Mode，它在需要执行终端命令时会直接行动，不再逐条征求同意。这是一个便利性与可控性之间的取舍：在你自己熟悉、且已经纳入版本控制的项目里开启比较稳妥；在陌生仓库或生产相关目录里，建议保持默认，让它先问你。

第四步：用 .junie 指南文件指导 Junie

Junie 支持用类似 .cursor/rules 的文档来指导智能体的工作方式。它会参照项目根目录中 .junie 目录下的文件来个性化自己的操作。也就是说，团队约定、代码风格、测试放在哪里、用哪个框架，这些都可以写进这个目录，让 Junie 每次都按同一套规矩来。

最省事的做法是让 Junie 自己生成第一版。把下面这段提示词作为新项目的第一步交给它：

分析项目结构和技术栈，并创建一个 .junie/guidelines.md 文件，包含简明、结构良好的信息，以帮助新开发人员。
包括关于组织结构、运行测试、执行脚本和遵循最佳实践的指导。
保持内容简短、清晰和实用。

这条指令会触发 Junie 去探索项目，过程大约持续 30 到 90 秒，期间它会执行类似 ls 这样的命令来摸清目录结构，然后生成这个文件。等它完成初步探索后，请仔细审查生成的结果，再补充你自己的定制需求。不要把它生成的内容当成最终版直接提交——它只是基于目录结构和常见约定做的推断，很多团队内部的隐性规则它猜不到。

第五步：手动编写或导入既有指南

你也可以完全跳过自动生成，从头手动创建这个文件，把现有的开发指南直接复制进去。如果团队之前在其他 AI 编辑器里已经写过一套指示文档，也可以把它们导入到 .junie 目录中复用。

.junie 下的文件可以包含任何格式的说明，不限于某一种固定模板。例如可以写这样一条约束：

生成的单元测试应始终添加到测试文件夹中，或使用特定框架。

如果仓库里本来就有现成的开发指南文档，也可以直接告诉 Junie 这些指南在哪里，例如指出正确的文件路径，它会去读取并应用。这比把内容复制一份到 .junie 里更不容易出现两份文档不同步的问题。

第六步：通过 VCS 共享给团队

.junie 目录可以随版本控制一起提交。提交之后，团队中的其他成员拉取代码就会自动参照这套设置，不需要每个人各自配置一遍。这也是把指南文件放进仓库而不是放在本地配置里的主要理由。

一个完整示例

下面把上面的步骤串成一个从头到尾能跑通的最小流程。假设你刚拿到 Junie 的使用资格，手上有一个已经纳入 Git 的小项目。

核对许可证。登录 JetBrains Account，在许可证页面确认 Junie 的状态正常。
安装插件。在 IDE 的插件市场搜索 Junie 并安装，重启 IDE，从侧边打开 Junie 工具窗口。
生成指南文件。在 Junie 工具窗口里输入第四步给出的那段提示词，让它分析项目结构并创建 .junie/guidelines.md。等待 30 到 90 秒，期间它会执行类似 ls 的命令探索目录。
审查并补充。打开生成的 .junie/guidelines.md，逐条核对。把不准确的内容删掉，补上它猜不到的团队约定，例如测试文件放在哪个目录、用哪个测试框架、脚本怎么执行。
提交指南。把 .junie 目录加入版本控制并提交，团队成员拉取后自动生效。
跑一个真实任务。在 IDE 的 Problems 窗口里挑一个静态检查报出的问题，把修复需求交给 Junie。观察它规划出的步骤，如果某一步方向不对，就在接续的聊天里指出并要求修正。
按需决定是否开启 Brave Mode。如果这个项目你非常熟悉，可以开启 Brave Mode 让它直接执行终端命令；否则保持默认，逐条确认。

走完这一遍，你就同时验证了两件事：插件链路是通的，指南文件也确实在影响它的行为。

注意事项

IDE 支持范围有限。目前只有 IntelliJ IDEA、PyCharm、WebStorm 三款 IDE 正式支持，GoLand 在内测，其他 IDE 仍在开发中。不要假设你惯用的 IDE 一定能用。
许可证要先确认。拿到资格不等于许可证已经生效，安装前先去许可证页面核对状态，可以省掉一轮排查。
指示质量直接决定结果质量。清晰、完整的指示会让 Junie 更有效；含糊或不完整的指导可能导致低质量的结果。这是使用这类智能体工具时最需要投入精力的地方。
自动生成的指南必须人工审查。Junie 探索项目只有 30 到 90 秒，它看到的是目录结构和常见约定，看不到你们团队的历史决策。生成结果要当作草稿。
Brave Mode 会跳过确认。开启后它在需要执行终端命令时直接行动，不再征求许可。在不确定的仓库里不要开。
善用接续对话纠偏。Junie 是分步执行的，某一步错了就在聊天里指出来，比等整个任务跑完再返工成本低得多。
指南文件可以更细。参考 .junie 目录中的文件组织方式，例如拆成 guideline.md、implementation.md、requirements.md 等，可以进一步提升 Junie 的工作效果。
易变信息以官网为准。支持范围、资格申请方式、是否收费、配额限制等都会变化，本文不给出具体数字，请以官网当前信息为准。