用IDEA在Windows上搭建chisel代码阅读环境——以香山处理器为例

注：本文所搭建的环境具有以下特征：

• 在Windows下能够阅读chisel代码（以香山处理器为例），并实现跳转
• 在Windows下用mill构建idea支持的工程

环境准备

1. Java环境搭建，网上教程很多，请自行百度，可以参考这篇文章。主要是将java添加到环境变量，直至在windows终端中出现：

PS C:\WINDOWS\system32> java --version
java 17.0.2 2022-01-18 LTS
Java(TM) SE Runtime Environment (build 17.0.2+8-LTS-86)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-LTS-86, mixed mode, sharing)

3. 安装IDEA（java类语言最强IDE），社区版即可，免费安装
4. 下载mill ：

• 介绍页面：https://com-lihaoyi.github.io/mill/mill/Intro_to_Mill.html
• 找到windows的版本下载：https://github.com/com-lihaoyi/mill/releases/download/0.10.9/0.10.9-assembly

下载会得到一个六十多M的文件：

4. 安装好git
5. 去GitHub 上克隆香山处理器工程：

git clone https://github.com/OpenXiangShan/XiangShan.git
cd XiangShan

6. 初始化香山工程

• 香山用到了一些GitHub上的开源工程，需用git工具克隆下来，香山的GitHub上使用的是make init，但在windows下并没有原生的make能使用，因此查看Makefile，可以看到：

init:
	git submodule update --init
	cd rocket-chip && git submodule update --init api-config-chipsalliance hardfloat

其实就是把上述命令手动输入一下就好

7. 生成.idea

• 将4中下载好的软件放置到XiangShan目录下，改名为mill.bat，同样查看Makefile

idea:
	mill -i mill.scalalib.GenIdea/idea

因此手动输入

.\mill.bat -i mill.scalabib.GenIdea/idea

如果成功，会生成.idea文件，即建立好了索引，用IDEA打开即可识别

8. 还需要在IDEA中安装scala插件，添加对scala的高亮支持

enjoy

注意：你需要顺畅的网络环境