mirror of
https://github.com/l0ng-ai/openidea.git
synced 2026-11-14 16:07:52 +00:00
79 lines
3.7 KiB
Plaintext
79 lines
3.7 KiB
Plaintext
---
|
||
title: "命令行"
|
||
description: "安装 openidea 命令，在终端中打开项目、定位到文件的某一行，或比较两个文件。"
|
||
---
|
||
|
||
`openidea` 命令可以在终端中用 OpenIDEA 打开文件夹和文件。应用未运行时会先启动它，把请求交给应用后命令立即返回。
|
||
|
||
## 安装命令
|
||
|
||
| 系统 | 菜单 |
|
||
| ---------------- | ----------------------------------- |
|
||
| macOS | **OpenIDEA › 安装 'openidea' 命令** |
|
||
| Windows 和 Linux | **工具 › 安装 'openidea' 命令** |
|
||
|
||
也可以在查找操作中运行这个操作。安装后请打开一个新的终端。
|
||
|
||
<Tabs>
|
||
<Tab title="macOS">
|
||
请先把 OpenIDEA 移到“应用程序”文件夹：命令是指向应用包内启动脚本的链接。如果 `~/.local/bin` 在 `PATH` 中，链接放在这里；否则放在 `/usr/local/bin`，此时可能需要输入管理员密码。
|
||
</Tab>
|
||
<Tab title="Windows">
|
||
安装时会在 `%LOCALAPPDATA%\OpenIDEA\bin` 中创建 `openidea.cmd`，并把该目录加入用户 `PATH`。安装版和便携版都适用，不需要管理员权限。
|
||
</Tab>
|
||
<Tab title="Linux">
|
||
安装时会创建 `~/.local/bin/openidea`。如果该目录不在 `PATH` 中，或者有其他 `openidea` 排在前面，通知会提示你把它加到 `PATH` 的最前面：
|
||
|
||
- Bash 和 Zsh：在 shell 配置文件中加入 `export PATH="$HOME/.local/bin:$PATH"`。
|
||
- Fish：运行 `fish_add_path --prepend ~/.local/bin`。
|
||
|
||
使用 AppImage 时，命令会直接启动这个 AppImage 文件，所以请把它放在固定位置。
|
||
|
||
</Tab>
|
||
</Tabs>
|
||
|
||
同一菜单中的 **卸载 'openidea' 命令** 只删除 OpenIDEA 自己的启动器（在 Windows 上还会移除对应的 `PATH` 条目）。属于其他应用的同名命令不会被覆盖或删除。移动便携版或 AppImage 之后，请重新安装命令。
|
||
|
||
## 用法
|
||
|
||
```text
|
||
openidea [options] [[--line <n>] [--column <n>] path[:line[:column]] ...]
|
||
openidea diff <left> <right>
|
||
```
|
||
|
||
```sh
|
||
openidea . # 把当前文件夹作为项目打开
|
||
openidea src/main.rs README.md # 打开文件
|
||
openidea --line 12 --column 5 src/main.rs
|
||
openidea src/main.rs:12:5 # 同上，写成 path:line:column
|
||
openidea diff before.txt after.txt # 比较两个文件
|
||
openidea # 把 OpenIDEA 窗口切到前台
|
||
```
|
||
|
||
- 文件夹作为项目打开。文件在包含它的项目窗口中打开；没有已打开的项目包含它时单独打开。
|
||
- 行号和列号从 1 开始。`--line` 和 `--column` 作用于紧随其后的路径。
|
||
- 只有当不存在完全同名的文件时，`path:line` 和 `path:line:column` 才会被解析为位置。
|
||
- 相对路径相对于当前目录解析。
|
||
- 文件名以 `-` 开头，或者文件名就是 `diff` 时，在它前面加 `--`。
|
||
|
||
## 选项
|
||
|
||
<ParamField path="--line <n>">把光标放在下一个文件的第 `n` 行。</ParamField>
|
||
|
||
<ParamField path="--column <n>">把光标放在该行的第 `n` 列。</ParamField>
|
||
|
||
<ParamField path="-h, --help">打印用法说明。</ParamField>
|
||
|
||
<ParamField path="-v, --version">打印版本号，例如 `OpenIDEA 0.1.40`。</ParamField>
|
||
|
||
## 退出码
|
||
|
||
OpenIDEA 接受请求后命令以 `0` 退出。遇到未知选项、文件不存在、无法连接到应用，或应用在 30 秒内没有启动完成时，以 `1` 退出，并输出 `openidea: <错误信息>`。
|
||
|
||
不安装命令时，GUI 可执行文件和系统的文件关联照常可用。
|
||
|
||
## 其他命令行工具
|
||
|
||
- `openidea-server`：在远程机器上运行 OpenIDEA 后端，用于远程开发。参见 [openidea-server](/zh/guide/remote/server)。
|
||
- `openidea-plugin`：创建、构建和打包插件。参见[插件快速开始](/zh/plugins/quickstart)。
|