IDEA on Liangweidong's blog

AI 编程工具链：Claude Code / OpenCode / Codex / Cursor / IDEA 实战

Mon, 15 Apr 2019 00:00:00 +0800

工具栈全景

工具	类型	特点
Claude Code	终端 Agent	Anthropic 官方、TUI 完整、plugin 生态
Codex CLI	终端 Agent	OpenAI 官方、原生 o3/o4 模型
OpenCode	终端 Agent	跨模型路由、Go 二进制、配置简单
Cursor	IDE	VSCode fork、AI 深度集成
IDEA 2026+	IDE	JetBrains、Java 主力、ACP 集成

一、Claude Code

安装

1
2
3
4
5
6


# Linux
curl -fsSL https://claude.ai/install.sh | bash
# 或固定版本
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# Windows
irm https://claude.ai/install.ps1 | iex
[Environment]::SetEnvironmentVariable("Path",
 [Environment]::GetEnvironmentVariable("Path", "User") + ";%USERPROFILE%\.local\bin",
 "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH",
 "<DEV_DIR>\Git\bin\bash.exe",
 [EnvironmentVariableTarget]::User)

# 验证
claude -v

默认目录

1
2
3
4
5
6
7
8
9


~/
├── .claude/
│ ├── backups/
│ ├── cache/
│ ├── downloads/
│ ├── telemetry/
│ ├── settings.json
│ └── CLAUDE.md # 全局配置
└── .claude.json # 状态 + 自定义配置

更新与卸载

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


# 更新
claude update
claude plugin marketplace update

# Linux 卸载
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude .mcp.json

# Windows 卸载
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

快捷键

键位	说明
shift + tab	切换权限模式（accept edits on）
alt + v	上传图片（Windows CLI）
tab	命令补全

用户级配置

1
2


# 复制 CLAUDE.md 到全局
cp -r /path/to/claude-code/CLAUDE.md ~/.claude/

~/.claude.json 配置

hasCompletedOnboarding: 跳过引导
mcpServers.MiniMax: 配置 MiniMax MCP（网络搜索 + 图片理解，支持 JPEG/PNG/GIF/WebP ≤ 20MB）

~/.claude/settings.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


{
 "env": {
 "CLAUDE_CODE_MAX_RETRIES": "50",
 "FORCE_AUTOUPDATE_PLUGINS": "1",
 "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1",
 "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GH_TOKEN>",
 "CLAUDE_CODE_EFFORT_LEVEL": "max",
 "API_TIMEOUT_MS": "3000000",
 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
 },
 "includeCoAuthoredBy": false,
 "statusLine": {
 "type": "command",
 "command": "npx -y ccstatusline@latest",
 "padding": 0
 },
 "skipWebFetchPreflight": true,
 "autoUpdatesChannel": "latest",
 "tui": "fullscreen",
 "skipDangerousModePermissionPrompt": true
}

多 Provider 切换

DeepSeek：

1
2
3
4
5
6
7


"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<YOUR_DEEPSEEK_KEY>",
"ANTHROPIC_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-chat"

MiniMax / Anthropic-compatible：

1
2
3
4
5
6
7


"ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<YOUR_KEY>",
"ANTHROPIC_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
"CLAUDE_CODE_SUBAGENT_MODEL": "MiniMax-M2.7"

Plugin 生态

oh-my-claudecode

1
2
3
4
5
6
7
8
9


claude
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
/reload-plugins

# 重启后配置
/omc-setup
# 全局范围 / ultrawork + 关键词 fast parallel / 跳过 MCP
# Agent Teams 启用，最大 5

关键词：

关键词	效果
ralph	持久模式
ralplan	迭代规划
ulw	最大并行
plan	规划访谈
team	协调代理

claude-mem

1
2
3
4
5
6
7
8
9


claude plugin marketplace add thedotmack/claude-mem
claude plugin install claude-mem
cd /home/user/.claude/plugins/cache/thedotmack/claude-mem/<version> && npm install

# 配置
"CLAUDE_MEM_MODE": "code--zh"

# Web UI
# http://localhost:37700

MCP 服务

draw-io

1

npm install -g @drawio/mcp

1
2
3
4
5
6
7
8


{
 "mcpServers": {
 "drawio": {
 "command": "cmd",
 "args": ["/c", "npx", "-y", "@drawio/mcp"]
 }
 }
}

Custom 命令（Slash Commands）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# ~/.claude/commands/fix-github-issue.md
请分析并修复 Github 问题：$ARGUMENTS。
按照这些步骤：
1. 使用 `gh issue view` 获取问题详情
2. 理解问题中描述的问题
3. 搜索代码库中的想上关文件
4. 实施必要的更改来修复问题
5. 编写并运行测试来验证修复
6. 确保代码通过代码检查和类型检查
7. 创建描述性的提交消息
8. 推送并创建 PR

# 用法
/fix-githhub-issue 1

二、Codex CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 安装
npm i -g @openai/codex

# 验证
codex --version
# codex-cli 0.122.0

# 更新
npm i -g @openai/codex@latest

# 配置
# ~/.codex
# 1. Sign in with ChatGPT
# 2. Sign in with Device Code
# 3. Provide Your Own API key

三、OpenCode

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 1. 卸载原 opencode-ai 包
npm uninstall -g opencode-ai

# 2. 清理 npm 缓存
npm cache clean --force

# 3. 安装（用 bun）
bun install -g opencode-ai
curl -fsSL https://opencode.ai/install | bash

# Windows
scoop install opencode

opencode -v

# 卸载
bun remove -g opencode-ai
bun remove -g opencode-linux-x64
bun remove -g opencode-linux-x64-baseline opencode-linux-x64-musl

配置火山引擎

1

cp -r opencode.json ~/.config/opencode/opencode.json

oh-my-openagent 插件

1
2
3
4


bunx oh-my-openagent install
bunx oh-my-openagent -v

cp -r oh-my-openagent.json ~/.config/opencode/oh-my-openagent.json

四、Cursor IDE

1

sudo dpkg -i ./cursor_3.3.30_amd64.deb # Linux

字体等宽问题

1
2
3
4


{
 "editor.fontFamily": "JetBrains Mono, Consolas, 'Courier New', monospace",
 "editor.disableMonospaceOptimizations": true
}

五、IDEA 2026.1

2026.1 起社区版和旗舰版包已经全并了，激活就是旗舰。

1
2
3
4


下载：https://www.jetbrains.com/idea/download/?section=windows
安装不运行
激活工具：portable/single/bin/jetbrains-crack-toolbox.exe
运行，扫描 IDE 和插件，安装补丁，一键激活

Cannot record performance 修复

Kali Linux 下 Cannot record performance: Cannot start the profiler: kernel variables are not configured。

1
2
3
4
5


sudo sh -c 'echo 1 > /proc/sys/kernel/perf_event_paranoid'

echo 'kernel.perf_event_paranoid=1' | sudo tee -a /etc/sysctl.conf
echo 'kernel.kptr_restrict=0' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

或 IDEA 设置：Build, Execution, Deployment → Java Profiler → 取消勾选 “Enable async profiler”。

ACP：链接 Claude Code

1

npm install -g @agentclientprotocol/claude-agent-acp

IDEA 设置 → Tools → AI Chat → Add Custom Agent：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


{
 "default_mcp_settings": {},
 "agent_servers": {
 "Claude Code Local": {
 "command": "npx.cmd",
 "args": ["@agentclientprotocol/claude-agent-acp"],
 "env": {
 "ACP_PERMISSION_MODE": "bypassPermissions"
 },
 "use_idea_mcp": true,
 "use_custom_mcp": true
 }
 }
}

IDEA 内置 MCP Server 端口 64342，可以用 SSE / HTTP stream 调用。

六、Obsidian 主题

主题：Blue Topaz
插件：Excalidraw、Outliner、Style Settings

下一步

想用 mmx-cli 生成封面图/调用 MiniMax 模型，看 .claude/skills/mmx-cli
想把 Claude Code 接入飞书/Telegram，看 cc-connect 文档

参考资料

Claude Code 官方：https://docs.claude.com/en/docs/claude-code
Codex CLI：https://github.com/openai/codex
OpenCode：https://opencode.ai
Cursor：https://www.cursor.com
IntelliJ IDEA：https://www.jetbrains.com/idea

WSL 远程开发环境搭建：从 Maven 到 IDE 集成

Sun, 15 Apr 2018 00:00:00 +0800

WSL 远程开发的核心理念

WSL 远程开发 = Linux 后端 + Windows 前端 IDE：

后端编译 / 构建 / 测试在 WSL（Linux 工具链）
前端编辑 / 调试 / Git 在 Windows（熟悉工具）
文件系统：项目放在 WSL，IDE 远程打开

好处：

Linux 工具链（apt、bash、coreutils）
Windows IDE（IntelliJ IDEA / VSCode / Cursor）
不需要 Dual Boot / VirtualBox
文件 IO 通过 9P 协议

WSL2 时代

2019 年 WSL2 GA 后，WSL 2 相比 WSL 1：

完整 Linux 内核
文件 IO 5~20 倍快
完整 syscall（Docker / ptrace / cgroups）

在 WSL 中安装 Maven

1. 准备

1
2
3
4
5
6
7
8


# 检查 WSL 版本
wsl -l -v
# NAME STATE VERSION
# Ubuntu-22.04 Running 2

# 切换默认用户为 root（可选）
# PowerShell 中：
wsl -u root -d Ubuntu-22.04

2. 下载 Maven

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


# 进入 WSL
wsl

# 切到 root（如有需要）
sudo su -

# 下载并解压到 /opt
cd /usr/local
sudo wget https://archive.apache.org/dist/maven/maven-3/3.9.14/binaries/apache-maven-3.9.14-bin.tar.gz

# 解压
sudo tar -zxvf apache-maven-3.9.14-bin.tar.gz -C /opt/

# 创建符号链接
sudo ln -s /opt/apache-maven-3.9.14 /opt/maven

3. 配置环境变量

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 写入 ~/.zshrc
sed -i '$a \
export M2_HOME=/opt/maven \
export PATH=$M2_HOME/bin:$PATH' ~/.zshrc

# 验证
cat ~/.zshrc | tail -5

# 重新加载
source ~/.zshrc

# 验证 Maven
mvn -v

输出：

1
2
3
4
5


Apache Maven 3.9.14 (9b613dcf7b...)
Maven home: /opt/maven
Java version: 21.0.10, vendor: Liberica, runtime: ...
Default locale: en, platform encoding: UTF-8
OS name: "linux", version: "...", arch: "amd64", family: "unix"

4. 配置 Maven 镜像

1
2


# 修改 settings.xml
nvim /opt/maven/conf/settings.xml

1
2
3
4
5
6


<mirror>
 <id>aliyun-public</id>
 <name>阿里云公共仓库</name>
 <url>https://maven.aliyun.com/repository/public</url>
 <mirrorOf>central</mirrorOf>
</mirror>

5. 用 sdkman 管理多版本（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 安装 sdkman
curl -s "https://get.sdkman.io" | bash
source ~/.sdkman/bin/sdkman-init.sh

# 装多个 Maven
sdk install maven 3.9.14
sdk install maven 3.8.9

# 切换
sdk use maven 3.9.14

IDE 集成 WSL

IntelliJ IDEA

打开 WSL 项目

File → New → Project from Existing Sources
浏览路径，输入 \\wsl$\Ubuntu-22.04\path\to\project
或：File → Open → Recent → WSL

配置 Maven 路径

Settings → Build, Execution, Deployment → Build Tools → Maven

Maven home directory: \\wsl$\Ubuntu-22.04\opt\maven
或：/opt/maven（用 WSL 内部路径）
User settings file: \\wsl$\Ubuntu-22.04\home\<user>\.m2\settings.xml
Local repository: \\wsl$\Ubuntu-22.04\home\<user>\.m2\repository

2024+ 的 IDEA Ultimate 支持 WSL 集成，直接识别 WSL 发行版，无需 \\wsl$ 前缀。

远程 SDK

Project Structure → Platform Settings → SDKs → + → WSL

选择 WSL 发行版（Ubuntu-22.04）
选择 Java 路径（如 /opt/jdk21）
OK

运行 / 调试

IDEA 直接在 WSL 中执行 mvn 命令。Console 输出在 WSL 终端（可在 IDEA 内部显示）。

VSCode / Cursor

安装 WSL 扩展

WSL（Microsoft 官方）

在 WSL 中打开

1
2
3
4
5


# PowerShell 中
wsl -d Ubuntu-22.04
code .
# 或
cursor .

配置

.vscode/settings.json：

1
2
3
4


{
 "remote.WSL.fileSystem.polling": true,
 "terminal.integrated.defaultProfile.linux": "zsh"
}

文件系统性能

WSL 1 vs WSL 2

场景	WSL 1	WSL 2
启动速度	快	中
文件 IO	慢（9P 桥接）	快（虚拟磁盘）
系统调用兼容	部分	完整
内存管理	共享	独立 VM

项目放哪？

位置	推荐	原因
WSL 内部（如 `~/projects/`）	✅	文件 IO 快
Windows（如 `C:\projects\`）	❌	跨 OS 文件 IO 慢

经验法则：把项目放在 WSL 文件系统（如 ~/projects/），IDE 通过 \\wsl$\... 访问。

WSL 配置

.wslconfig（Windows 用户目录）

1
2
3
4
5
6
7


[wsl2]
memory=4GB # 限制 WSL 内存
processors=4 # 限制 CPU 核数
swap=8GB # Swap 大小
swapFile=D:\wsl-swap.vhdx
localhostForwarding=true
sparseVhd=true # 自动压缩 vhdx

wsl.conf（WSL 内部）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# /etc/wsl.conf
[automount]
enabled=true
options=metadata,umask=022
mountFsTab=true

[network]
generateHosts=true
generateResolvConf=true

[interop]
enabled=true
appendWindowsPath=true

常见工作流

工作流 1：纯 Linux 开发

1
2
3
4
5


wsl
cd ~/projects/my-app
# 用 vim / nano / emacs 编辑
mvn clean package
java -jar target/my-app.jar

工作流 2：混合开发（推荐）

Windows 端：IDEA / VSCode / Cursor 打开项目
后端编译运行在 WSL
数据库 / Redis / Nginx 用 docker compose（WSL 内）
浏览器 / Postman / 数据库客户端在 Windows

工作流 3：远程 SSH 风格

1
2
3
4
5


# 用 Windows Terminal + SSH 客户端
ssh user@your-wsl-host

# 或直接 PowerShell 进入
wsl ~ -d Ubuntu-22.04

Docker in WSL

WSL2 内 Docker 部署有 3 种方案：

方案 1：Docker Desktop for Windows（推荐）

自动用 WSL2 后端
Docker CLI 也在 WSL 中可用
适合一般场景

方案 2：WSL 独立 Docker daemon

1
2
3
4


# 在 WSL 内安装 docker.io
sudo apt install -y docker.io
sudo systemctl start docker
sudo usermod -aG docker $USER

方案 3：Rancher Desktop / Podman

轻量替代 Docker Desktop
完全开源

网络访问

WSL2 通过 localhost 与 Windows 互访：

WSL 访问 Windows：http://host.docker.internal 或 \\wsl$\
Windows 访问 WSL：http://localhost:<port>（WSL 转发到 Windows localhost）

1
2


# .wslconfig
localhostForwarding=true

调试案例

问题 1：Maven 找不到 JAVA_HOME

1
2
3
4
5
6
7


# 检查
echo $JAVA_HOME
which java
java -version

# 设置
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

问题 2：IDEA 找不到 WSL 路径

Settings → Appearance & Behavior → System Settings → WSL：

启用 WSL 集成
选择发行版

问题 3：文件修改无响应

IDEA 默认每 3 秒刷新文件。WSL 文件变更需要更频繁：

1
2
3
4
5
6
7


// .vscode/settings.json
{
 "files.watcherExclude": {
 "**/target/**": true,
 "**/node_modules/**": true
 }
}

项目级 init 脚本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


#!/bin/bash
# ~/bin/dev-env.sh

# 安装基础工具链
sudo apt update
sudo apt install -y openjdk-21-jdk maven nodejs npm zsh git curl

# 安装 oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
chsh -s $(which zsh)

# 安装 sdkman
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# 安装 Maven
sdk install maven 3.9.14

# 装 IDEA 替代品（可选）
# ...

完整开发体验检查清单

WSL2 已启用
zsh + oh-my-zsh + Powerlevel10k
fcitx5 五笔
sdkman 管理 JDK / Maven
Docker Desktop 或 WSL Docker
Git 配置（user.name / user.email）
SSH key 已加到 GitHub
项目在 ~/projects/（WSL 文件系统）
IDE 通过 \\wsl$\... 打开
中文字体（Cantarell / Fira Code / Meslo）

下一步

WSL 完整使用手册，看 2017-01-15《WSL2 完整使用手册》
Linux 工作站基础配置，看 2014-01-15《Linux 工作站基础配置》
远程开发常见问题排查，看 2018-04-15 后 WSL2 高级用法

参考资料

WSL 官方文档：https://learn.microsoft.com/en-us/windows/wsl/
Maven 官方：https://maven.apache.org/
sdkman：https://sdkman.io/
IntelliJ IDEA WSL 集成：https://www.jetbrains.com/help/idea/how-to-use-wsl-development-environment.html

IDEA Vim 模拟器：IdeaVim 键位映射与高效编辑

Mon, 15 Aug 2016 00:00:00 +0800

什么是 IdeaVim

IdeaVim 是 JetBrains 官方维护的 IDEA Vim 模拟器插件，2013 年首次发布。它让 JetBrains 全家桶（IntelliJ IDEA、PyCharm、WebStorm、GoLand、CLion 等）支持 Vim 键位，且与 IDE 自身的快捷键无缝融合。

安装

Settings → Plugins → Marketplace
搜索 IdeaVim 或 Vim
安装
重启 IDE

提示：JetBrains 2024+ 起 IdeaVim 2.x 系列支持更多 Vim 特性（visual block、text objects、surround 等）。

启用与禁用

Tools → Vim（菜单切换）
或快捷键：Ctrl + Alt + V（部分版本）

启用后编辑区光标变成方块，Vim 模式生效；禁用后回到 IDEA 原生模式。

Vim 模式

IdeaVim 完整支持 Vim 6 大模式：

模式	进入	说明
Normal	ESC	默认模式，移动光标、操作文本
Insert	i / a / o	插入文本
Visual	v / V / Ctrl+v	选择文本
Command-line	:	执行命令
Replace	R	替换模式
Ex	Q	批量命令

.ideavimrc 配置文件

IdeaVim 用 .ideavimrc 配置文件（类比 Vim 的 .vimrc），路径：

Windows：%USERPROFILE%\.ideavimrc
Linux/Mac：~/.ideavimrc

基础配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


" 1. Leader 键改为逗号（默认是 \）
let mapleader = ","

" 2. 启用常用插件
set surround
set commentary
set highlightsearch
set textobj-entire
set ideajoin

" 3. 显示相对行号（Vim 风格）
set relativenumber
" 4. 显示当前行号
set number
" 5. 显示匹配括号
set showmatch
" 6. 忽略大小写搜索
set ignorecase
" 7. 增量搜索
set incsearch
" 8. 智能大小写（小写搜索时忽略大写）
set smartcase

" 9. 关闭 IDE 选中后自动复制
set "ideaput"

自定义快捷键

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


" 跳转
nmap <Leader>gd <Action>(GotoDeclaration)
nmap <Leader>gi <Action>(GotoImplementation)
nmap <Leader>gr <Action>(FindUsages)
nmap <Leader>fs <Action>(FileStructurePopup)
nmap <Leader>ff <Action>(SearchEverywhere)
nmap <Leader>rb <Action>(RenameElement)
nmap <Leader>rf <Action>(RefactorThis)

" 调试
nmap <F5> <Action>(Debug)
nmap <F9> <Action>(ToggleLineBreakpoint)

" Git
nmap <Leader>gc <Action>(Git.Commit)
nmap <Leader>gp <Action>(Git.Push)

" 注释（用 commentary 插件）
nmap <Leader>c gcc
vmap <Leader>c gc

" 环绕（用 surround 插件）
" ysiw" 给单词加双引号
" cs"' 把双引号改成单引号
" ds" 删除包裹

完整动作定义

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


" 跳到行尾
nmap <Leader>e <End>

" 全局搜索
nmap <Leader>/ <Action>(SearchEverywhere)

" 重命名
nmap <Leader>r <Action>(RenameElement)

" 实现方法
nmap <Leader>i <Action>(ImplementMethods)

" 快速修复
nmap <Leader>. <Action>(ShowIntentionActions)

" 切换文件
nmap <Leader>e <Action>(RecentFiles)

" 分屏
nmap <Leader>v <Action>(SplitVertically)
nmap <Leader>s <Action>(SplitHorizontally)

IDE 动作（Action）速查

IdeaVim 用 <Action>(ActionId) 调用 IDE 原生功能。常用 Action ID：

Action ID	作用
`GotoDeclaration`	跳到声明（Ctrl + B）
`FindUsages`	查找用法（Alt + F7）
`RenameElement`	重命名（Shift + F6）
`ShowIntentionActions`	快速修复（Alt + Enter）
`SearchEverywhere`	全局搜索（Shift + Shift）
`RecentFiles`	最近文件（Ctrl + E）
`FileStructurePopup`	文件结构（Ctrl + F12）
`GotoClass`	跳到类（Ctrl + N）
`GotoFile`	跳到文件（Ctrl + Shift + N）
`GotoSymbol`	跳到符号（Ctrl + Alt + Shift + N）
`ToggleLineBreakpoint`	切换断点（Ctrl + F8）
`Debug`	Debug 模式运行
`Run`	Run 模式运行
`Git.Commit`	Git 提交
`Git.Pull`	Git 拉取
`Git.Push`	Git 推送
`SplitVertically`	垂直分屏
`SplitHorizontally`	水平分屏
`GotoNextSplitter`	下一个分屏

查看所有 Action ID：Help → Find Action... → Ctrl + Shift + A，记下 ID。

Vim 与 IDEA 快捷键冲突

常见冲突和解决：

冲突	解决
`Ctrl + F`（Vim 翻页 vs IDEA 查找）	在 `.ideavimrc` 里 `nmap <C-f> <C-d>`
`Ctrl + A`（Vim 行首 vs IDEA 全选）	保留 IDEA（不在 `.ideavimrc` 写）
`Ctrl + W`（Vim 切换分屏 vs IDEA 关闭标签）	`nmap <C-w> <Action>(Switcher)`

1
2


" 关闭 Vim 自己的 Ctrl + W 分屏，改用 IDEA 的"切换 Tab"
nmap <silent> <C-w> <Action>(Switcher)

完整 .ideavimrc 实战模板

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84


" ============ 基础设置 ============
set nocompatible
let mapleader = ","
set relativenumber
set number
set showmatch
set ignorecase
set incsearch
set smartcase
set wrapscan
set hlsearch
set scrolloff=5

" ============ 启用插件 ============
set commentary
set surround
set highlightsearch
set ideajoin
set textobj-entire
set argtextobj
set ReplaceWithRegister
set MultipleCursors
set Easymotion

" ============ 动作映射 ============
" 跳转
nmap <Leader>gd <Action>(GotoDeclaration)
nmap <Leader>gi <Action>(GotoImplementation)
nmap <Leader>gr <Action>(FindUsages)
nmap <Leader>fs <Action>(FileStructurePopup)
nmap <Leader>ff <Action>(SearchEverywhere)
nmap <Leader>fb <Action>(RecentFiles)
nmap <Leader>fc <Action>(GotoClass)
nmap <Leader>ff <Action>(GotoFile)
nmap <Leader>fs <Action>(GotoSymbol)

" 重构
nmap <Leader>rn <Action>(RenameElement)
nmap <Leader>rm <Action>(RefactorThis)
nmap <Leader>im <Action>(ImplementMethods)
nmap <Leader>ov <Action>(OverrideMethods)

" 调试
nmap <F5> <Action>(Debug)
nmap <F9> <Action>(ToggleLineBreakpoint)
nmap <F8> <Action>(StepOver)
nmap <F7> <Action>(StepInto)
nmap <F11> <Action>(ToggleFullScreen)

" Git
nmap <Leader>gc <Action>(Git.Commit)
nmap <Leader>gp <Action>(Git.Push)
nmap <Leader>gl <Action>(Git.Pull)
nmap <Leader>gs <Action>(Git.Branches)

" 编辑
nmap <Leader>tt <Action>(ReformatCode)
nmap <Leader>oi <Action>(OptimizeImports)
nmap <Leader>cc <Action>(ShowIntentionActions)
nmap <Leader>. <Action>(ShowIntentionActions)

" 注释
nmap <Leader>c gcc
vmap <Leader>c gc
nmap <Leader>u gc
vmap <Leader>u gc

" 环绕
" ysiw" - 单词加双引号
" cs'" - 双引号改单引号
" dst - 删 tag
" yss) - 整行加括号

" 多光标
" <C-n> 下个匹配
" <C-p> 上个匹配
" <C-x> 跳过
" gb 选下一个匹配
" gB 全选匹配

" Easymotion
" <Leader><Leader>w - 跳到任意单词
" <Leader><Leader>f - 跳到任意字符
" <Leader><Leader>j - 跳到任意行

IDEA 模式 vs Vim 模式切换

Vim 用户最不习惯 IDEA 的"无模式"——按什么都直接输入。

两种工作流：

纯 Vim 流

全程用 Vim 模式，禁用 IDE 大部分快捷键：

1
2
3
4


" 在 .ideavimrc 把 IDE 冲突键全部拦截
nmap <C-a> <Nop> " 禁用 Ctrl + A（全选改成 ggVG）
nmap <C-c> <Nop>
" ...

混合流

Vim 模式 + 必要的 IDE 快捷键：

用 jk 退出 Insert（自定义映射）
用 , 前缀触发动作（上面模板）
偶尔用 IDE 搜索窗、Database 工具

常见问题

中文输入法卡 Vim 模式

jk 退出 Insert 时，中文输入法候选框会出现 jk。解决：

1
2


" 把 jk 改成 <Esc> 的映射，并用 timeout
inoremap <silent> jk <ESC>

`<Esc>` 太远

1
2
3
4


" CapsLock 映射为 <Esc>（系统级，Karabiner-Elements / PowerToys）
" 或用 jj
inoremap jj <ESC>
inoremap jk <ESC>

鼠标选择冲突

1
2
3


" 鼠标拖动 = Visual 模式
set "selectmode"
set "keymodel"

IDE 重启后配置失效

.ideavimrc 必须放在用户目录根下，不要放进项目 .git/。路径：

Windows：C:\Users\<USER>\.ideavimrc
Linux/Mac：~/.ideavimrc

下一步

想学 Vimscript 写复杂映射，看 :help vimscript
想要完整 Vim 体验（脱离 IDE），看 2018-01-15《Windows 开发工具链》中 Neovim 章节
想用 Tmux + Vim 搭远程工作流，看 2018-04-15《WSL 远程开发环境搭建》

参考资料

IdeaVim 官方：https://github.com/JetBrains/ideavim
IdeaVim 文档：https://jb.gg/ideavim
Vim 官方文档：https://www.vim.org/docs.php
Vim 速查：https://vim.rtorr.com/

2024+ 视角（IdeaVim 与 AI 编辑时代）

2016 年写 IdeaVim 时，JetBrains IDE 还是"事实标准"；到 2024-2026 年，编辑器生态发生了几个显著变化：

IdeaVim 2.x 系列（2024）：
- Visual Block 模式全面支持（类似 Vim 的 <C-v>）
- Text Objects 增强（if/af、ic/ac 等）
- Surround 完整支持（含嵌套 tag）
- Action Lists 改进（<Action> 调用更稳定）
JetBrains 2024+ 重大事件：
- AI Assistant（JetBrains AI）整合到 IDE，2024 年 GA
- Junie（JetBrains AI Agent）—— 自动完成 PR 级别的多文件改动
- Fleet（JetBrains 轻量编辑器）也支持 IdeaVim 插件
Cursor / Trae / Windsurf 等 AI IDE 崛起：
- Cursor（基于 VSCode 魔改）支持 Vim 模式 + AI 内联编辑
- Trae / Windsurf（IDE 派）也支持 Vim 模式
- VSCode + VSCodeVim 仍是 Vim 模式兼容性最强的组合
Neovim 的回归：
- Neovim 0.10+（2024）稳定，LSP 原生支持、Tree-sitter 高亮、内置 LSP/补全让 Neovim 成为"现代 IDE"
- LazyVim / NvChad / LunarVim 等发行版让"Neovim 一键现代化"
- AstroNvim / LazyVim 配合 Mason 管理 LSP/DAP/Formatter
远程开发的 Vim 优势放大：
- JetBrains Gateway + Code With Me —— 远程开发标配
- VSCode Remote SSH / Dev Containers —— Vim 模式在远程场景体验更顺
- tmux + Neovim 仍是远程开发的"小而美"方案
键位映射的"经验"沉淀：
- .ideavimrc 仍然推荐 git 化——团队共享配置
- CapsLock → Esc 在 2024 年被 Karabiner-Elements（Mac）/ PowerToys Keyboard Manager（Windows）原生支持
- Space 键作 Leader 成为新趋势（Vim 社区主流）
AI 时代的 Vim 哲学：
- “组合 + 正则"思想在 AI 编辑中反而被弱化（AI 直接生成代码）
- 但"导航效率"价值仍在——Vim 用户在长文件中仍然比 GUI 用户快 2-3 倍
- Helix editor（Rust 出品，Vim 风格但更现代化）成为 2024 年新选项

2024 实战建议：

坚持 JetBrains 系（IDEA、GoLand、PyCharm）：IdeaVim 2.x + .ideavimrc + CapsLock → Esc
VSCode 系：原生 Vim 模式 + VSCodeVim 插件 + AI 插件（GitHub Copilot / Cursor / Cline）
追求"现代 IDE + Vim”：Neovim + LazyVim（一键配置好 LSP / Treesitter / DAP）
远程开发：JetBrains Gateway / VSCode Remote SSH / Tailscale SSH

2016 年这篇的".ideavimrc 配置 + 动作映射"框架至今仍可用——变化的是 JetBrains AI 集成、Neovim 现代化、AI IDE 崛起。但 Vim 哲学（编辑即组合、键盘胜于鼠标）依然是 2024+ 工程师最值得保留的肌肉记忆。

Git 四大区与 Shelve 搁置：从入门到 IDEA 实战

Tue, 15 Sep 2015 00:00:00 +0800

Git 四大区

Git 内部有 4 个工作区域：

区域	英文	说明
工作区	Working Directory	本地写代码的目录
暂存区	Staging Area / Index	`git add` 后的"准备提交"区
本地仓库	Local Repository	`git commit` 后的本地历史
远程仓库	Remote Repository	`git push` 后的云端历史

1
2
3
4


工作区（写代码）
 → git add → 暂存区（准备提交） git stash 隐藏更改
 → git commit → 本地仓库（本地保存）
 → git push → 远程仓库（云端保存）

git stash 是隐藏工作区的更改到栈里（不提交到任何区），方便你拉最新代码或者切换任务。

git stash：紧急任务切换

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 当前正在改功能 A，写了一半
# 突然来了 bugB 要修

# 1. 把功能 A 暂存起来
git stash

# 2. 拉最新代码
git pull origin master

# 3. 切到 bug 分支修
git checkout -b fix-bugB
# ... 改完、commit、push、merge ...

# 4. 切回功能 A 分支
git checkout feature-A

# 5. 恢复暂存
git stash pop

# 6. 继续功能 A 开发

stash 是栈结构，支持多个：

1
2
3
4
5


git stash # 暂存当前
git stash list # 查看所有 stash
git stash apply stash@{0} # 应用指定 stash
git stash drop stash@{0} # 删除指定 stash
git stash pop # 应用并删除最近一个

git restore：撤销本地的编辑

1
2
3
4
5
6
7
8


# 撤销工作区的修改（未 add）
git restore 文件1 文件2

# 撤销暂存（已 add，但未 commit）
git restore --staged 文件1 文件2

# 撤销工作区 + 暂存
git restore --staged --worktree 文件1

IDEA 中的回滚：

VCS → Git → Restore File：相当于 git restore
Local History → Show History：IDEA 自动保存的本地历史
VCS → Git → Reset HEAD：回滚所有未提交修改

IDEA 的 reset 默认不删除"已提交"的文件副本，所以回滚不删除文件——已跟踪的文件从绿变红。

git HEAD：指针机制

HEAD 是当前分支最新提交的"指针"。

HEAD^：上一个提交（HEAD~1）
HEAD^^：上上一个（HEAD~2）
HEAD@{2}：reflog 中第 3 个 HEAD 位置（用于找回 reset 掉的 commit）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 查看 reflog
git reflog

# 把 HEAD 切到上一个提交
git checkout HEAD^

# 恢复误删的分支
git reflog
# 找到 commit SHA
git checkout -b recovered-branch <SHA>

git restore vs git checkout vs git reset 三者区别

命令	作用
`git restore <file>`	撤销工作区/暂存区的修改（Git 2.23+ 新命令）
`git checkout -- <file>`	同上（旧语法）
`git reset --soft HEAD^`	撤销 commit，保留暂存
`git reset --mixed HEAD^`	撤销 commit + 暂存，保留工作区
`git reset --hard HEAD^`	撤销 commit + 暂存 + 工作区（危险，慎用）

IDEA 的 Shelve 搁置

什么是 Shelve

IDEA 的 Shelve（搁置） 是 JetBrains IDE 独有的功能，定位：

【任务切换神器】 不是为了拉代码，是为了 把写一半的功能收起来，去干别的事。

它像一个临时的、私有的、微型补丁分支——不污染 git 历史，跨分支切换时不被带走。

使用场景

1
2
3
4
5
6
7
8


正在写【功能 A】，写了一半
突然来了【紧急 bugB】要修！
不想提交 A，也不想删 A

→ 把 A 搁置（Shelve）起来
→ 工作区变干净
→ 去修 bugB
→ 修完把 A 恢复回来继续

操作步骤

Git → Uncommitted Changes → Shelve Changes…
命名（建议"功能A-2026-06-04"）
工作区立刻变干净
切到 bugB 分支修
修完提交
Git → Uncommitted Changes → Unshelve… 选之前搁置的名字
恢复继续功能 A

与 git stash 的区别：Shelve 是 IDE 本地的，跨电脑不共享；stash 是 git 仓库级别的，commit 后可推送。

git-crypt：透明加密

团队项目经常需要提交敏感配置（.env、数据库密码），但又怕直接 push 到公网。git-crypt 是 Git 的透明加密插件：

文件本地是明文
git push 后云端是密文
团队成员对称加密：每个有 GPG key 的人都能解密

1
2
3
4
5
6
7
8


# Linux 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-linux-x86_64

# Windows 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-x86_64.exe

# 放到 PATH
mv git-crypt-0.7.0-x86_64 /usr/local/bin/git-crypt

配置 .gitattributes

1
2
3
4
5


# .gitattributes
.env filter=git-crypt diff=git-crypt
config/prod.yaml filter=git-crypt diff=git-crypt
*.key filter=git-crypt diff=git-crypt
*.pem filter=git-crypt diff=git-crypt

初始化

1
2
3


git-crypt init
git add .gitattributes
git commit -m "Add git-crypt config"

添加 GPG 协作者

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 协作者生成 GPG key
gpg --gen-key
# 上传公钥到 keyserver
gpg --keyserver keys.openpgp.org --send-keys <KEY_ID>

# 信任他
git-crypt add-gpg-user <GPG_USER_ID>

# 协作者 clone 后 unlock
git-crypt unlock

常用命令速查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# 远程分支
git branch -r

# 检出远程分支
git checkout release_V3.1.4

# 关联分支
git branch --set-upstream-to=origin/master master

# 查看单个文件的历史
git log -p -- path/to/file

# 暂存部分文件
git add -p
# y/n/q/a/d 等交互式命令

# 撤销合并
git revert -m 1 <merge_commit_sha>

# 修改最后一次 commit
git commit --amend

# 改作者邮箱（全局）
git filter-branch --env-filter 'GIT_AUTHOR_EMAIL=xxx'

下一步

想用 GitHub Actions 自动化 CI，看 2017-12-08《K8s Ingress 实战》
想用 monorepo 工具（pnpm + turbo）管理多项目，看 2020-04-15《FSS 全栈脚手架》

参考资料

Pro Git 简体中文：https://git-scm.com/book/zh/v2
git-crypt：https://github.com/AGWA/git-crypt
IDEA Shelve 文档：https://www.jetbrains.com/help/idea/shelving-and-unshelving-changes.html

插件	命令
surround	`cs"'` `ysiw"` `ds"`
commentary	`gcc` `gc`（注释/反注释）
highlightsearch	高亮搜索结果
textobj-entire	`ae` / `ie` 整个文件
ideajoin	`J` 智能合并（不删多余空格）
argtextobj	`aa` / `ia` 函数参数
ReplaceWithRegister	`gr` 用寄存器替换
MultipleCursors	`gb` 多光标（仿 Sublime）
EmacsProTabMotion	仿 Emacs Tab 切换
Easymotion	`s` + 字符跳转到任意位置

IDEA on Liangweidong's blog

AI 编程工具链：Claude Code / OpenCode / Codex / Cursor / IDEA 实战

工具栈全景

一、Claude Code

安装

默认目录

更新与卸载

快捷键

用户级配置

~/.claude.json 配置

~/.claude/settings.json

多 Provider 切换

Plugin 生态

推荐安装

oh-my-claudecode

claude-mem

MCP 服务

draw-io

Custom 命令（Slash Commands）

二、Codex CLI

三、OpenCode

配置火山引擎

oh-my-openagent 插件

四、Cursor IDE

字体等宽问题

五、IDEA 2026.1

Cannot record performance 修复

ACP：链接 Claude Code

六、Obsidian 主题

下一步

参考资料

WSL 远程开发环境搭建：从 Maven 到 IDE 集成

WSL 远程开发的核心理念

WSL2 时代

在 WSL 中安装 Maven

1. 准备

2. 下载 Maven

3. 配置环境变量

4. 配置 Maven 镜像

5. 用 sdkman 管理多版本（推荐）

IDE 集成 WSL

IntelliJ IDEA

打开 WSL 项目

配置 Maven 路径

远程 SDK

运行 / 调试

VSCode / Cursor

安装 WSL 扩展

在 WSL 中打开

配置

文件系统性能

WSL 1 vs WSL 2

项目放哪？

WSL 配置

.wslconfig（Windows 用户目录）

wsl.conf（WSL 内部）

常见工作流

工作流 1：纯 Linux 开发

工作流 2：混合开发（推荐）

工作流 3：远程 SSH 风格

Docker in WSL

方案 1：Docker Desktop for Windows（推荐）

方案 2：WSL 独立 Docker daemon

方案 3：Rancher Desktop / Podman

网络访问

调试案例

问题 1：Maven 找不到 JAVA_HOME

问题 2：IDEA 找不到 WSL 路径

问题 3：文件修改无响应

项目级 init 脚本

完整开发体验检查清单

下一步

参考资料

IDEA Vim 模拟器：IdeaVim 键位映射与高效编辑

什么是 IdeaVim

安装

启用与禁用

Vim 模式

.ideavimrc 配置文件

基础配置

`<Esc>` 太远