Zedの設定
Zedは設定可能になるように設計されています。私たちは、あなたのワークフローと好みに正確に適合させたいと考えています。可能な限り多くの人々にとって快適な出発点となるように設計されたデフォルト設定を提供していますが、それを調整して素晴らしいと感じられるように楽しんでいただけることを願っています。
ここに記載されている設定に加えて、テーマを変更したり、キーバインドを設定したり、タスクを設定したり、拡張機能をインストールすることもできます。
設定ファイル
設定ファイルは、cmd-,
(macOSの場合)またはctrl-,
(Linuxの場合)で開くことができます。デフォルトでは、~/.config/zed/settings.json
にあります。ただし、Linux環境でXDG_CONFIG_HOMEを設定している場合は、代わりに$XDG_CONFIG_HOME/zed/settings.json
にあります。
この設定は、プロジェクト内のローカル設定とマージされます。コマンドパレットからzed: ローカル設定を開く
を実行して、プロジェクト設定を開くことができます。これにより、.zed/settings.json
を含む.zed
ディレクトリが作成されます。
ほとんどのプロジェクトではルートに1つの設定ファイルのみが必要になりますが、必要に応じてサブディレクトリに追加のローカル設定ファイルを追加できます。ローカルファイルで設定できるのは、エディターと言語ツールの動作に影響を与えるものだけです。たとえば、tab_size
、formatter
などを設定できますが、theme
、vim_mode
などは設定できません。
設定ファイルの構文は、//
コメントを許可するJSONのスーパーセットです。
デフォルト設定
現在のZedのデフォルト設定は、コマンドパレットからzed: デフォルト設定を開く
を実行して確認できます。
言語サーバーを提供する拡張機能も、それらの言語サーバーのデフォルト設定を提供する場合があります。
設定
アクティブペインの拡大
- 説明:アクティブなペインをズームするスケール。
1.0
に設定すると、アクティブなペインは他のペインと同じサイズになりますが、より大きな値に設定すると、アクティブなペインはより多くのスペースを占有します。 - 設定:
active_pane_magnification
- デフォルト:
1.0
オプション
float
値
自動保存
- 説明:編集されたバッファを自動的に保存するタイミング。
- 設定:
autosave
- デフォルト:
off
オプション
- 自動保存を無効にするには、
off
に設定します
{
"autosave": "off"
}
- フォーカスが変更されたときに自動保存するには、
on_focus_change
を使用します
{
"autosave": "on_focus_change"
}
- アクティブウィンドウが変更されたときに自動保存するには、
on_window_change
を使用します
{
"autosave": "on_window_change"
}
- 非アクティブ期間後に自動保存するには、
after_delay
を使用します
{
"autosave": {
"after_delay": {
"milliseconds": 1000
}
}
}
自動更新
- 説明:自動的に更新を確認するかどうか。
- 設定:
auto_update
- デフォルト:
true
オプション
boolean
値
バッファフォントファミリー
- 説明:エディターでテキストをレンダリングするために使用するフォントの名前。
- 設定:
buffer_font_family
- デフォルト:
Zed Plex Mono
オプション
ユーザーのシステムにインストールされているフォントファミリーの名前
バッファフォント機能
- 説明:エディターでテキストに対して有効にするOpenType機能。
- 設定:
buffer_font_features
- デフォルト:
null
オプション
Zedは、特定のバッファまたはターミナルフォントに対して有効または無効にできるすべてのOpenType機能をサポートしています。また、フォント機能の値を設定することもできます。
たとえば、フォントリガチャを無効にするには、次の設定をに追加します
{
"buffer_font_features": {
"calt": false
}
}
cv01
を7
に設定するなど、他のOpenType機能も設定できます
{
"buffer_font_features": {
"cv01": 7
}
}
バッファフォントサイズ
- 説明:エディターでテキストのデフォルトフォントサイズ。
- 設定:
buffer_font_size
- デフォルト:
15
オプション
integer
値
バッファフォントウェイト
- 説明:エディターでテキストのデフォルトフォントウェイト。
- 設定:
buffer_font_weight
- デフォルト:
400
オプション
100
から900
の間のinteger
値
バッファ行の高さ
- 説明:エディターでテキストのデフォルトの行の高さ。
- 設定:
buffer_line_height
- デフォルト:
"comfortable"
オプション
"standard"
、"comfortable"
、または{"custom": float}
(1
は非常にコンパクト、2
は非常に緩い)
終了の確認
- 説明:アプリケーションを閉じる前に、ユーザーに確認を求めるかどうか。
- 設定:
confirm_quit
- デフォルト:
false
オプション
boolean
値
中央配置レイアウト
- 説明:中央配置レイアウトモードの設定。
- 設定:
centered_layout
- デフォルト
"centered_layout": {
"left_padding": 0.2,
"right_padding": 0.2,
}
オプション
left_padding
およびright_padding
オプションは、中央配置レイアウトモードがアクティブ化されたときのワークスペースからの中心ペインの左右のパディングの相対的な幅を定義します。有効な値の範囲は0
から0.4
です。
Direnv統合
- 説明:direnv統合の設定。
direnv
がインストールされている必要があります。direnv
統合は現在、direnv
設定によって設定された環境変数が、インストールする代わりに$PATH
で一部の言語サーバーを検出するために使用できることを意味します。 - 設定:
load_direnv
- デフォルト
"load_direnv": "shell_hook"
オプション 次の2つのオプションから選択できます
shell_hook
:シェルフックを使用してdirenvをロードします。これは、ディレクトリに入るときにdirenvがアクティブになることに依存します。POSIXシェルとfishをサポートします。direct
:direnv export json
を使用してdirenvをロードします。これにより、シェル フックに依存せずにdirenvが直接ロードされるため、矛盾が生じる可能性があります。これにより、direnvは任意のシェルで動作できます。
インライン補完
- 説明:インライン補完の設定。
- 設定:
inline_completions
- デフォルト
"inline_completions": {
"disabled_globs": [
".env"
]
}
オプション
無効化されたグロブ
- 説明:インライン補完を無効にする必要のあるファイルを表すグロブのリスト。
- 設定:
disabled_globs
- デフォルト:[".env"]
オプション
string
値のリスト
現在の行のハイライト
- 説明:エディターで現在の行を強調表示する方法。
- 設定:
current_line_highlight
- デフォルト:
all
オプション
- 現在の行を強調表示しない
"current_line_highlight": "none"
- ガター領域を強調表示する
"current_line_highlight": "gutter"
- エディター領域を強調表示する
"current_line_highlight": "line"
- 行全体を強調表示する
"current_line_highlight": "all"
カーソルの点滅
- 説明:カーソルを点滅させるかどうか。
- 設定:
cursor_blink
- デフォルト:
true
オプション
boolean
値
デフォルトのドックアンカー
- 説明:新しいドックのデフォルトのアンカー。
- 設定:
default_dock_anchor
- デフォルト:
bottom
オプション
- ワークスペースの下部にドックを配置します:
bottom
- サイドパネルのようにワークスペースの右側にドックを配置します:
right
- ワークスペース全体にフルスクリーンでドックを配置します:
expanded
エディタースクロールバー
- 説明:エディタースクロールバーと、その中のさまざまな要素を表示するかどうか。
- 設定:
scrollbar
- デフォルト
"scrollbar": {
"show": "auto",
"cursors": true,
"git_diff": true,
"search_results": true,
"selected_symbol": true,
"diagnostics": true
},
表示モード
- 説明:エディタースクロールバーをいつ表示するか。
- 設定:
show
- デフォルト:
auto
オプション
- 重要な情報がある場合、またはシステムで構成された動作に従う場合は、スクロールバーを表示します
"scrollbar": {
"show": "auto"
}
- システムで構成された動作に合わせる
"scrollbar": {
"show": "system"
}
- 常にスクロールバーを表示する
"scrollbar": {
"show": "always"
}
- スクロールバーを非表示にする
"scrollbar": {
"show": "never"
}
カーソルインジケーター
- 説明:スクロールバーにカーソルの位置を表示するかどうか。
- 設定:
cursors
- デフォルト:
true
オプション
boolean
値
Git差分インジケーター
- 説明:スクロールバーにgit差分インジケーターを表示するかどうか。
- 設定:
git_diff
- デフォルト:
true
オプション
boolean
値
検索結果インジケーター
- 説明:スクロールバーにバッファ検索結果を表示するかどうか。
- 設定:
search_results
- デフォルト:
true
オプション
boolean
値
選択されたシンボルインジケーター
- 説明:スクロールバーに選択されたシンボルの出現箇所を表示するかどうか。
- 設定:
selected_symbol
- デフォルト:
true
オプション
boolean
値
診断
- 説明:スクロールバーに診断インジケーターを表示するかどうか。
- 設定:
diagnostics
- デフォルト:
true
オプション
boolean
値
エディタータブバー
- 説明:エディターのタブバーに関連する設定。
- 設定:
tab_bar
- デフォルト
"tab_bar": {
"show": true,
"show_nav_history_buttons": true
}
表示
- 説明:エディターにタブバーを表示するかどうか。
- 設定:
show
- デフォルト:
true
オプション
boolean
値
ナビゲーション履歴ボタン
- 説明:ナビゲーション履歴ボタンを表示するかどうか。
- 設定:
show_nav_history_buttons
- デフォルト:
true
オプション
boolean
値
エディタータブ
- 説明:エディタータブの設定。
- 設定:
tabs
- デフォルト
"tabs": {
"close_position": "right",
"file_icons": false,
"git_status": false
},
閉じる位置
- 説明:タブ内の閉じるボタンを表示する場所。
- 設定:
close_position
- デフォルト:
right
オプション
- 右側に閉じるボタンを表示する
{
"close_position": "right"
}
- 左側に閉じるボタンを表示する
{
"close_position": "left"
}
ファイルアイコン
- 説明:タブのファイルアイコンを表示するかどうか。
- 設定:
file_icons
- デフォルト:
false
Gitステータス
- 説明:タブにGitファイルのステータスを表示するかどうか。
- 設定:
git_status
- デフォルト:
false
エディターツールバー
- 説明:エディターツールバーにさまざまな要素を表示するかどうか。
- 設定:
toolbar
- デフォルト
"toolbar": {
"breadcrumbs": true,
"quick_actions": true
},
オプション
各オプションは、特定のツールバー要素の表示を制御します。すべての要素が非表示になっている場合、エディターツールバーは表示されません。
言語サーバーの有効化
- 説明:コードインテリジェンスを提供するために言語サーバーを使用するかどうか。
- 設定:
enable_language_server
- デフォルト:
true
オプション
boolean
値
保存時に最終改行を保証
- 説明:保存時にバッファの最後に1つの改行があることを保証するかどうか。
- 設定:
ensure_final_newline_on_save
- デフォルト:
true
オプション
boolean
値
LSP
- 説明:言語サーバーの設定。
- 設定:
lsp
- デフォルト:
null
オプション
次の設定は、特定の言語サーバーで上書きできます
initialization_options
言語の設定を上書きするには、その言語サーバーの名前のエントリをlsp
の値に追加します。例
"lsp": {
"rust-analyzer": {
"initialization_options": {
"check": {
"command": "clippy" // rust-analyzer.check.command (default: "check")
}
}
}
}
保存時にフォーマット
- 説明:保存前にバッファのフォーマットを実行するかどうか。
- 設定:
format_on_save
- デフォルト:
on
オプション
on
: 保存時に、formatter
設定に従ってフォーマットを有効にします。
{
"format_on_save": "on"
}
off
: 保存時のフォーマットを無効にします。
{
"format_on_save": "off"
}
フォーマッター
- 説明: バッファーのフォーマットを実行する方法。
- 設定:
formatter
- デフォルト:
auto
オプション
- 現在の言語サーバーを使用するには、
"language_server"
を使用します。
{
"formatter": "language_server"
}
- または、外部コマンドを使用するには、
"external"
を使用します。実行するフォーマットプログラムの名前と、プログラムに渡す引数の配列を指定します。バッファーのテキストは標準入力でプログラムに渡され、フォーマットされた出力は標準出力に書き込まれる必要があります。たとえば、次のコマンドは、sed(1)
を使用して末尾のスペースを削除します。
{
"formatter": {
"external": {
"command": "sed",
"arguments": ["-e", "s/ *$//"]
}
}
}
- または、接続された言語サーバーによって提供されるコードアクションを使用するには、
"code_actions"
を使用します(Zed0.130.x
が必要)。
{
"formatter": {
"code_actions": {
// Use ESLint's --fix:
"source.fixAll.eslint": true,
// Organize imports on save:
"source.organizeImports": true
}
}
}
フォーマット時のコードアクション
- 説明: バッファーをフォーマットするときに、プライマリ言語サーバーで実行するコードアクション。
- 設定:
code_actions_on_format
- デフォルト:
{}
。ただし、Go の場合は{ "source.organizeImports": true }
です。
例
- TypeScript および TSX バッファーでフォーマット時にインポートを整理する
{
"languages": {
"TypeScript": {
"code_actions_on_format": {
"source.organizeImports": true
}
},
"TSX": {
"code_actions_on_format": {
"source.organizeImports": true
}
}
}
}
- フォーマット時に ESLint の
fixAll
コードアクションを実行する(Zed0.125.0
が必要)
{
"languages": {
"JavaScript": {
"code_actions_on_format": {
"source.fixAll.eslint": true
}
}
}
}
fixAll
を使用するときに単一の ESLint ルールのみを実行する(Zed0.125.0
が必要)
{
"languages": {
"JavaScript": {
"code_actions_on_format": {
"source.fixAll.eslint": true
}
}
},
"lsp": {
"eslint": {
"settings": {
"codeActionOnSave": {
"rules": ["import/order"]
}
}
}
}
}
自動閉じ
- 説明: 開き括弧、角括弧、中括弧、単一引用符または二重引用符の文字を入力するときに、一致する閉じ文字を自動的に追加するかどうか。
- 設定:
use_autoclose
- デフォルト:
true
オプション
boolean
値
常に括弧を自動閉じとして扱う
- 説明: エディターが自動閉じ文字をどのように処理するかを制御します。
- 設定:
always_treat_brackets_as_autoclosed
- デフォルト:
false
オプション
boolean
値
例
設定が true
に設定されている場合
- エディターで入力:
)))
- カーソルを先頭に移動:
^)))
- 再度入力:
)))
結果はまだ )))
であり、デフォルトの場合の ))))))
ではありません。
ファイルタイプ
- 設定:
file_types
- 説明: Zed がファイル名または拡張子に基づいてファイルの言語を選択する方法を設定します。glob エントリをサポートします。
- デフォルト:
{}
例
すべての .c
ファイルを C++ として、MyLockFile
という名前のファイルを TOML として、Dockerfile
で始まるファイルを Dockerfile として解釈するには
{
"file_types": {
"C++": ["c"],
"TOML": ["MyLockFile"],
"Dockerfile": ["Dockerfile*"]
}
}
Git
- 説明: Git 関連機能の設定。
- 設定:
git
- デフォルト
{
"git": {
"git_gutter": "tracked_files",
"inline_blame": {
"enabled": true
}
}
}
Git ガター
- 説明: Git ガターを表示するかどうか。
- 設定:
git_gutter
- デフォルト:
tracked_files
オプション
- 追跡されたファイルに Git ガターを表示する
{
"git": {
"git_gutter": "tracked_files"
}
}
- Git ガターを非表示にする
{
"git": {
"git_gutter": "hide"
}
}
インデントガイド
- 説明: インデントガイドに関連する設定(Zed
0.138.0
が必要)。インデントガイドは、言語ごとに個別に設定できます。 - 設定:
indent_guides
- デフォルト
{
"indent_guides": {
"enabled": true,
"line_width": 1,
"active_line_width": 1,
"coloring": "fixed",
"background_coloring": "disabled"
}
}
オプション
- インデントガイドを無効にする
{
"indent_guides": {
"enabled": false
}
}
- 特定の言語のインデントガイドを有効にする。
{
"languages": {
"Python": {
"indent_guides": {
"enabled": true
}
}
}
}
- インデントを認識した色付け(「虹色インデント」)を有効にします。異なるインデントレベルに使用される色は、テーマで定義されています(テーマキー:
accents
)。これらは、テーマのオーバーライドを使用してカスタマイズできます。
{
"indent_guides": {
"enabled": true,
"coloring": "indent_aware"
}
}
- インデントを認識した背景色付け(「虹色インデント」)を有効にします。異なるインデントレベルに使用される色は、テーマで定義されています(テーマキー:
accents
)。これらは、テーマのオーバーライドを使用してカスタマイズできます。
{
"indent_guides": {
"enabled": true,
"coloring": "indent_aware",
"background_coloring": "indent_aware"
}
}
インライン Git Blame
- 説明: 現在フォーカスされている行に、Git Blame 情報をインラインで表示するかどうか(Zed
0.132.0
が必要)。 - 設定:
inline_blame
- デフォルト
{
"git": {
"inline_blame": {
"enabled": true
}
}
}
オプション
- インライン Git Blame を無効にする
{
"git": {
"inline_blame": {
"enabled": false
}
}
}
- カーソルの移動が停止した後に開始される遅延の後でのみ、インライン Git Blame を表示する
{
"git": {
"inline_blame": {
"enabled": false,
"delay_ms": 500
}
}
}
ハードタブ
- 説明: 行をインデントするために、タブ文字を使用するか、複数のスペースを使用するか。
- 設定:
hard_tabs
- デフォルト:
false
オプション
boolean
値
ホバーポップオーバーの有効化
- 説明: エディターでシンボルにマウスを移動したときに、情報ホバーボックスを表示するかどうか。
- 設定:
hover_popover_enabled
- デフォルト:
true
オプション
boolean
値
インレイヒント
- 説明: エディターにヒント付きの追加テキストを表示するための設定。
- 設定:
inlay_hints
- デフォルト
"inlay_hints": {
"enabled": false,
"show_type_hints": true,
"show_parameter_hints": true,
"show_other_hints": true,
"edit_debounce_ms": 700,
"scroll_debounce_ms": 50
}
オプション
インレイヒントのクエリは、エディター(クライアント)と LSP サーバーの 2 つの部分で構成されます。上記のインレイ設定がヒントを有効にするように変更されると、エディターは特定の種類のヒントのクエリを開始し、サーバーからの LSP ヒント更新リクエストに応答します。この時点で、サーバーはその実装に応じてヒントを返す場合と返さない場合があります。さらに構成が必要になる場合があります。対応する LSP サーバーのドキュメントを参照してください。
次の言語には、Zed によって事前構成されたインレイヒントがあります。
サーバー構成には lsp
セクションを使用します。例は、対応する言語のドキュメントに記載されています。
ヒントは Zed で即座にクエリされるのではなく、2 種類のデバウンスが使用され、いずれも 0 に設定して無効にすることができます。設定関連のヒント更新はデバウンスされません。
ジャーナル
- 説明: ジャーナルの設定。
- 設定:
journal
- デフォルト
"journal": {
"path": "~",
"hour_format": "hour12"
}
パス
- 説明: ジャーナルエントリが保存されるディレクトリのパス。
- 設定:
path
- デフォルト:
~
オプション
string
値
時間形式
- 説明: ジャーナルで時間を表示するために使用する形式。
- 設定:
hour_format
- デフォルト:
hour12
オプション
- 12時間形式
{
"hour_format": "hour12"
}
- 24時間形式
{
"hour_format": "hour24"
}
言語
- 説明: 特定の言語の設定。
- 設定:
languages
- デフォルト:
null
オプション
言語の設定を上書きするには、その言語の名前のエントリを languages
値に追加します。例
"languages": {
"C": {
"format_on_save": "off",
"preferred_line_length": 64,
"soft_wrap": "preferred_line_length"
},
"JSON": {
"tab_size": 4
}
}
次の設定は、特定の言語ごとに上書きできます
enable_language_server
ensure_final_newline_on_save
format_on_save
formatter
hard_tabs
preferred_line_length
remove_trailing_whitespace_on_save
show_inline_completions
show_whitespaces
soft_wrap
tab_size
use_autoclose
always_treat_brackets_as_autoclosed
これらの値は、同じ名前のルートレベル設定と同じオプションを受け入れます。
プレビュータブ
-
説明: (Zed
0.132.x
が必要)
プレビュータブを使用すると、ファイルをプレビューモードで開くことができます。プレビューモードでは、明示的にピン留めしない限り、別のファイルに切り替えると自動的に閉じます。これは、ワークスペースを散らかさずにファイルをすばやく表示するのに役立ちます。プレビュータブには、ファイル名が斜体で表示されます。
プレビュータブを通常のタブに変換する方法はいくつかあります- ファイルをダブルクリックする
- タブヘッダーをダブルクリックする
project_panel::OpenPermanent
アクションを使用する- ファイルを編集する
- ファイルを別のペインにドラッグする
-
設定:
preview_tabs
-
デフォルト
"preview_tabs": {
"enabled": true,
"enable_preview_from_file_finder": false,
"enable_preview_from_code_navigation": false,
}
ファイルファインダーからのプレビューを有効にする
- 説明: ファイルファインダーから選択したときに、ファイルをプレビューモードで開くかどうかを決定します。
- 設定:
enable_preview_from_file_finder
- デフォルト:
false
オプション
boolean
値
コードナビゲーションからのプレビューを有効にする
- 説明: コードナビゲーションを使用してタブから移動するときに、プレビュータブが置き換えられるかどうかを決定します(Zed
0.134.x
が必要)。 - 設定:
enable_preview_from_code_navigation
- デフォルト:
false
オプション
boolean
値
推奨行の長さ
- 説明: ソフトラップが有効になっているバッファーの場合、行をソフトラップする列。
- 設定:
preferred_line_length
- デフォルト:
80
オプション
integer
値
プロジェクトのオンラインデフォルト
- 説明: オンラインプロジェクトビューをデフォルトで表示するかどうか。
- 設定:
projects_online_by_default
- デフォルト:
true
オプション
boolean
値
保存時に末尾の空白を削除する
- 説明: バッファーを保存する前に、バッファーの行から末尾の空白を削除するかどうか。
- 設定:
remove_trailing_whitespace_on_save
- デフォルト:
true
オプション
boolean
値
コールステータスアイコンを表示する
- 説明: ステータスバーにコールステータスアイコンを表示するかどうか。
- 設定:
show_call_status_icon
- デフォルト:
true
オプション
boolean
値
入力時に補完を表示する
- 説明: 入力時に補完を表示するかどうか。
- 設定:
show_completions_on_input
- デフォルト:
true
オプション
boolean
値
補完ドキュメントを表示する
- 説明: 補完メニューの項目のインラインおよび横にドキュメントを表示するかどうか。
- 設定:
show_completion_documentation
- デフォルト:
true
オプション
boolean
値
補完ドキュメントのデバウンス遅延
- 説明: 元の補完リストに含まれていない場合に、補完ドキュメントの言語サーバーへの再クエリ前のデバウンス遅延。
- 設定:
completion_documentation_secondary_query_debounce
- デフォルト:
300
ミリ秒
オプション
integer
値
インライン補完を表示する
- 説明: 入力時、または
editor::ShowInlineCompletion
をトリガーして手動でインライン補完を表示するかどうか。 - 設定:
show_inline_completions
- デフォルト:
true
オプション
boolean
値
空白文字を表示する
- 説明: エディターで空白文字をレンダリングするかどうか。
- 設定:
show_whitespaces
- デフォルト:
selection
オプション
すべて
選択
なし
境界
ソフトラップ
- 説明: テキストの行をエディター/推奨幅に合わせて自動的に折り返すかどうか。
- 設定:
soft_wrap
- デフォルト:
prefer_line
オプション
- ソフトラップを停止するには
none
- 通常、行が長すぎる場合を除き、折り返しを避けるには
prefer_line
- エディターの幅を超えた行を折り返すには
editor_width
preferred_line_length
設定値を超えた行を折り返すにはpreferred_line_length
ラップガイド (垂直ルーラー)
- 説明: ラップガイドとして垂直ルーラーを表示する場所。
show_wrap_guides
をfalse
に設定して無効にします。 - 設定:
wrap_guides
- デフォルト: []
オプション
integer
列番号のリスト
タブサイズ
- 説明: 各タブ文字に使用するスペースの数。
- 設定:
tab_size
- デフォルト:
4
オプション
integer
値
テレメトリー
- 説明: Zed によって収集される情報を制御します。
- 設定:
telemetry
- デフォルト
"telemetry": {
"diagnostics": true,
"metrics": true
},
オプション
診断
- 説明: クラッシュレポートなどのデバッグ関連データを送信するための設定。
- 設定:
diagnostics
- デフォルト:
true
オプション
boolean
値
メトリクス
- 説明: Zed で使用している言語などの匿名化された使用状況データを送信するための設定。
- 設定:
metrics
- デフォルト:
true
オプション
boolean
値
ターミナル
- 説明: ターミナルの設定。
- 設定:
terminal
- デフォルト
"terminal": {
"alternate_scroll": "off",
"blinking": "terminal_controlled",
"copy_on_select": false,
"env": {},
"font_family": null,
"font_features": null,
"font_size": null,
"option_as_meta": false,
"button": false,
"shell": {},
"toolbar": {
"title": true
},
"working_directory": "current_project_directory"
}
代替スクロール
- 説明: 代替スクロールモード (DECSET コード:
?1007
) をデフォルトでアクティブにするかどうかを設定します。代替スクロールモードでは、代替画面 (vim や less などのアプリケーションを実行する場合など) でマウススクロールイベントが上/下キー押下キーに変換されます。ターミナルは、ANSI エスケープコードを使用して、このモードを設定および設定解除できます。 - 設定:
alternate_scroll
- デフォルト:
off
オプション
- デフォルトの代替スクロールモードをオンにする
{
"alternate_scroll": "on"
}
- デフォルトの代替スクロールモードをオフにする
{
"alternate_scroll": "off"
}
点滅
- 説明: ターミナルでのカーソルの点滅動作を設定します
- 設定:
blinking
- デフォルト:
terminal_controlled
オプション
- ターミナルモードを無視して、カーソルを点滅させない
{
"blinking": "off"
}
- カーソルの点滅をデフォルトでオフにし、ターミナルで点滅をオンにできるようにする
{
"blinking": "terminal_controlled"
}
- 常にカーソルを点滅させ、ターミナルのモードを無視する
"blinking": "on",
選択時にコピー
- 説明:ターミナルでテキストを選択した際に、自動的にシステムクリップボードにコピーするかどうか。
- 設定:
copy_on_select
- デフォルト:
false
オプション
boolean
値
環境変数
- 説明:このオブジェクトに追加されたキーと値のペアは、ターミナルの環境変数に追加されます。キーは一意である必要があり、単一の変数に複数の値を設定する場合は
:
で区切ります - 設定:
env
- デフォルト:
{}
例
"env": {
"ZED": "1",
"KEY": "value1:value2"
}
フォントサイズ
- 説明:ターミナルで使用するフォントサイズ。設定されていない場合は、エディターのフォントサイズに一致するようにデフォルト設定されます
- 設定:
font_size
- デフォルト:
null
オプション
integer
値
フォントファミリー
- 説明:ターミナルで使用するフォント。設定されていない場合は、エディターのフォントに一致するようにデフォルト設定されます。
- 設定:
font_family
- デフォルト:
null
オプション
ユーザーのシステムにインストールされているフォントファミリーの名前
フォント機能
- 説明:ターミナルで使用するフォント機能。設定されていない場合は、エディターのフォント機能に一致するようにデフォルト設定されます。
- 設定:
font_features
- デフォルト:
null
オプション
バッファフォント機能を参照
OptionキーをMetaキーとして使用
- 説明:OptionキーをEmacsのように「meta」キーとして再解釈します。
- 設定:
option_as_meta
- デフォルト:
true
オプション
boolean
値
シェル
- 説明:ターミナル起動時に使用するシェル。
- 設定:
shell
- デフォルト:
system
オプション
- システムのデフォルトターミナル設定を使用します(通常は
/etc/passwd
ファイル)。
{
"shell": "system"
}
- 起動するプログラム
"shell": {
"program": "sh"
}
- 引数付きのプログラム
"shell": {
"with_arguments": {
"program": "/bin/bash",
"args": ["--login"]
}
}
ターミナルツールバー
- 説明:ターミナルツールバーにさまざまな要素を表示するかどうか。エディターペインに配置されたターミナルにのみ影響します。
- 設定:
toolbar
- デフォルト
"toolbar": {
"title": true,
},
オプション
現時点では、title
オプションのみが利用可能で、PROMPT_COMMAND
を介して変更できるターミナルタイトルの表示を制御します。タイトルが非表示の場合、ターミナルツールバーは表示されません。
ターミナルボタン
- 説明:ステータスバーにターミナルボタンを表示または非表示にするためのコントロール
- 設定:
button
- デフォルト:
true
オプション
boolean
値
作業ディレクトリ
- 説明:ターミナル起動時に使用する作業ディレクトリ。
- 設定:
working_directory
- デフォルト:
"current_project_directory"
オプション
- 現在のファイルのプロジェクトディレクトリを使用します。失敗した場合は、最初のプロジェクトディレクトリ戦略にフォールバックします
{
"working_directory": "current_project_directory"
}
- このワークスペースの最初のプロジェクトディレクトリを使用します。フォールバックして、このプラットフォームのホームディレクトリを使用します。
{
"working_directory": "first_project_directory"
}
- 常にこのプラットフォームのホームディレクトリを使用します(見つかった場合)。
{
"working_directory": "always_home"
}
- 常に特定のディレクトリを使用します。この値はシェル展開されます。このパスが有効なディレクトリでない場合、ターミナルはこのプラットフォームのホームディレクトリをデフォルトで使用します。
"working_directory": {
"always": {
"directory": "~/zed/projects/"
}
}
テーマ
- 説明:テーマ設定は、テーマの名前として、またはZed UIの
mode
、dark
、およびlight
テーマを含むオブジェクトとして、2つの形式で指定できます。 - 設定:
theme
- デフォルト:
One Dark
テーマオブジェクト
- 説明:
mode
、dark
、およびlight
テーマを含むオブジェクトを使用してテーマを指定します。 - 設定:
theme
- デフォルト
"theme": {
"mode": "system",
"dark": "One Dark",
"light": "One Light"
},
モード
- 説明:テーマモードを指定します。
- 設定:
mode
- デフォルト:
system
オプション
- テーマをダークモードに設定する
{
"mode": "dark"
}
- テーマをライトモードに設定する
{
"mode": "light"
}
- テーマをシステムモードに設定する
{
"mode": "system"
}
ダーク
- 説明:UIに使用するダークZedテーマの名前。
- 設定:
dark
- デフォルト:
One Dark
オプション
コマンドパレットでtheme selector: toggle
アクションを実行して、有効なテーマ名の現在のリストを確認してください。
ライト
- 説明:UIに使用するライトZedテーマの名前。
- 設定:
light
- デフォルト:
One Light
オプション
コマンドパレットでtheme selector: toggle
アクションを実行して、有効なテーマ名の現在のリストを確認してください。
Vim
- 説明:vimモードを有効にするかどうか(開発中)。
- 設定:
vim_mode
- デフォルト:
false
プロジェクトパネル
- 説明:プロジェクトパネルをカスタマイズします
- 設定:
project_panel
- デフォルト
"project_panel": {
"button": true,
"dock": "left",
"git_status": true,
"default_width": "N/A - width in pixels"
},
ドック
- 説明:ドックの位置を制御します
- 設定:
dock
- デフォルト:
left
オプション
- デフォルトのドック位置を左に設定します
{
"dock": "left"
}
- デフォルトのドック位置を右に設定します
{
"dock": "right"
}
Gitステータス
- 説明:新規作成および更新されたファイルを示します
- 設定:
git_status
- デフォルト:
true
- デフォルトでgitステータスを有効にする
{
"git_status": true
}
- デフォルトでgitステータスを無効にする
{
"git_status": false
}
デフォルト幅
- 説明:プロジェクトパネルのデフォルト幅をカスタマイズします
- 設定:
default_width
- デフォルト: N/A ピクセル単位の幅(例:420)
オプション
boolean
値
通話
- 説明:通話参加時の動作をカスタマイズします
- 設定:
calls
- デフォルト
"calls": {
// Join calls with the microphone live by default
"mute_on_join": false,
// Share your project when you are the first to join a channel
"share_on_join": false
},
設定例
// ~/.config/zed/settings.json
{
"theme": "cave-light",
"tab_size": 2,
"preferred_line_length": 80,
"soft_wrap": "none",
"buffer_font_size": 18,
"buffer_font_family": "Zed Plex Mono",
"autosave": "on_focus_change",
"format_on_save": "off",
"vim_mode": false,
"projects_online_by_default": true,
"terminal": {
"font_family": "FiraCode Nerd Font Mono",
"blinking": "off"
},
"languages": {
"C": {
"format_on_save": "language_server",
"preferred_line_length": 64,
"soft_wrap": "preferred_line_length"
}
}
}