starred/openidea
1
0
Fork 0
mirror of https://github.com/l0ng-ai/openidea.git synced 2026-11-14 16:07:52 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
14bb7bcc6fa5d2cbec210dd4e2eedc99e44db52c
openidea/docs/en/guide/migrate.mdx
T
Alexanderandformiat 6f62917730 feat(toolwindows): Dock Unpinned and Undock view modes (#2802) 
A tool window's Options menu gets a View Mode submenu with Dock Pinned (the default), Dock Unpinned and Undock, as actions `toolwindow.viewMode.dockPinned|dockUnpinned|undock` (category Window). Unpinned and undocked windows hide when focus moves to the editor or another tool window, not to a popup, menu or dialog; an undocked window lies over the editor at its side without resizing it, and its inner edge resizes it. The mode is kept per window in the project layout, saved with Tool Window Layouts and reset by Restore Default Layout.

A menu button in a tool window now takes focus when clicked: WebKit doesn't focus clicked buttons, so the menu returned focus to the editor on close and hid a window just switched to Dock Unpinned or Undock.

Co-authored-by: formiat <29867335+formiat@users.noreply.github.com>
2026-11-12 03:05:08 +08:00

99 lines
7.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "Migrate from another IDE"
description: "Pick a familiar keymap, bring over settings, themes and run configurations, and map concepts from IntelliJ IDEA, VS Code and Eclipse."
---
OpenIDEA follows IntelliJ IDEA's model: a folder is a project, features live in tool windows, and almost everything is reachable from Search Everywhere or Find Action. This page covers what you can bring with you and where familiar things live.
## Choose a keymap
OpenIDEA ships six keymaps:
| Keymap | Based on |
| ------------------------------------------ | --------------------------------------------------------------------------------------------- |
| **macOS** | IntelliJ IDEA's macOS keymap. The default on macOS. |
| **Windows** | IntelliJ IDEA's Windows keymap. The default on Windows and Linux. |
| **VS Code (macOS)**, **VS Code (Windows)** | Visual Studio Code's default shortcuts. Actions VS Code has no shortcut for are left unbound. |
| **Eclipse (macOS)**, **Eclipse** | IntelliJ IDEA's Eclipse keymaps. |
Switch keymaps in any of these places:
- Welcome screen › **Customize** › **Keymap**
- **Settings › Keymap**
- **View › Quick Switch Scheme…** (`` ⌃` `` / `` Ctrl+` ``) › **Keymap**
You can change single shortcuts on top of any keymap, or duplicate one into your own. See [Keymaps](/en/guide/keymap).
## From IntelliJ IDEA and other JetBrains IDEs
The defaults already match IDEA: the keymap, tool window numbers (`⌘1` / `Alt+1` for Project, `⌘9` / `Alt+9` for Git), `⇧⇧` / `Shift Shift` for Search Everywhere and `⌥↵` / `Alt+Enter` for context actions.
A tool window's options menu (`⋮`) has IDEA's **View Mode**: **Dock Pinned** (the default); **Dock Unpinned**, which hides the window when you click into the editor or another tool window; and **Undock**, which shows the window over the editor without resizing it and hides it the same way. Float and Window are not available.
### Import settings
Use **File › Manage IDE Settings › Import Settings from JetBrains IDE…** and pick one of the JetBrains IDEs found on this computer. To use a `settings.zip` exported from a JetBrains IDE instead, choose **File › Manage IDE Settings › Import Settings…** and select the zip.
A confirmation lists what will be imported before anything changes:
- Color schemes (the `.icls` files) and the color scheme in use
- Editor font: family, size, line spacing (as line height) and ligatures
- Trailing-space stripping, final newline on save, sticky lines, whitespace display, soft wraps
- **Confirm before exiting the IDE**
Keymaps, code styles, live templates, inspection profiles and plugins are not imported; the confirmation lists the ones it skipped. Imported values go to the global settings.
### Import a theme
With a project open, go to **Settings › Plugins**, open the gear menu and choose:
- **Import Theme from JetBrains IDE…** to pick a theme plugin installed in your JetBrains IDEs, or
- **Import IntelliJ Theme from File…** for a theme plugin `.jar`, a Marketplace `.zip`, a plugin folder or a `.theme.json` file.
The theme is converted into an OpenIDEA theme plugin and installed. Select it in **Settings › Appearance & Behavior › Appearance › Theme**. See [Themes and fonts](/en/guide/themes).
### Import run configurations
Run **Import Run Configurations from JetBrains (.run, .idea)** from Find Action, or use the import link in **Run › Edit Configurations…**. OpenIDEA reads the project's `.run` and `.idea` run configurations it can map; a notification says how many came in and why others were left out.
### IdeaVim
Vim mode reads `~/.ideavimrc` (or `~/.openideavimrc`). Turn it on with **Tools › Vim**. See [Vim mode](/en/guide/vim).
## From VS Code
Pick **VS Code (macOS)** or **VS Code (Windows)** as the keymap; then `⇧⌘P` / `Ctrl+Shift+P` opens Find Action and `⌘P` / `Ctrl+P` opens Go to File as you expect.
| In VS Code | In OpenIDEA |
| -------------------- | -------------------------------------------------------------------------------------------------------------- |
| Command Palette | **Find Action** (`⇧⌘A` / `Ctrl+Shift+A` in the default keymap) |
| Quick Open | **Go to File** (`⇧⌘O` / `Ctrl+Shift+N`), or **Search Everywhere** (`⇧⇧` / `Shift Shift`) |
| Explorer | **Project** tool window (`⌘1` / `Alt+1`) |
| Problems panel | **Problems** tool window (`⌘6` / `Alt+6`) |
| Integrated terminal | **Terminal** tool window (`⌥F12` / `Alt+F12`) |
| Source Control | **Commit** tool window (`⌘0` / `Alt+0`) and **Git** tool window (`⌘9` / `Alt+9`) |
| Extensions | **Settings › Plugins** |
| `settings.json` | **Settings** (`⌘,` / `Ctrl+Alt+S`), stored in `settings.toml`; per-project values in `.openidea/settings.toml` |
| `launch.json` | Run configurations: **Import Run Configurations from .vscode/launch.json** |
| Multi-root workspace | **File › New Workspace…** and **Attach Project…** |
`.editorconfig` files are applied. VS Code settings and extensions are not imported.
## From Eclipse
Pick **Eclipse (macOS)** or **Eclipse** as the keymap.
- **Formatter.** To keep using an Eclipse formatter profile for Java, open **Settings › Editor › Code Style › Java**, set **Formatting profile** to **Custom Eclipse formatter XML** and choose the exported XML file.
- **Workspaces and projects.** Eclipse opens many projects in one workspace. OpenIDEA opens one project per window; to work on several folders together, create a workspace with **File › New Workspace…** or add folders with **Attach Project…**.
- **Perspectives.** OpenIDEA has no perspectives. Arrange tool windows the way you like and save the arrangement with **Window › Tool Window Layouts › Save Current Layout as…**.
## Concepts at a glance
| Concept | In OpenIDEA |
| ----------------- | ----------------------------------------------------------------------------------------------------------- |
| Project | A folder you open. Project settings and shared run configurations live in its `.openidea/` folder. |
| Tool window | A panel at the window edge: Project, Git, Run, Debug, Terminal and others. Toggle with its number shortcut. |
| Action | Every command has an action you can run from **Find Action** and bind in **Settings › Keymap**. |
| Run configuration | What to run or debug and how; see [Run configurations](/en/guide/run). |
| Language server | The process that provides code insight for a language; see [Languages](/en/languages/index). |
Reference in New Issue View Git Blame Copy Permalink