設定が反映されない

本ページでは、settings.json の設定が期待通りに反映されない問題のトラブルシューティングについて説明します。設定の仕組みについては、構成ファイルと適用順序および構成項目、環境変数、およびファイルパスを参照してください。

再起動が必要：一部の構成項目には「再起動が必要」と記載されており、変更後に Qoder CLI を再起動しないと反映されません。構成項目、環境変数、およびファイルパスで確認してください。
より高い優先度による上書き：優先度の高いレベル（ローカルレベル > プロジェクトレベル > ユーザーレベル）で同じ項目が設定されており、優先度の低い設定が上書きされていないか確認してください。
コマンドラインによる上書き：--settings で渡された設定はすべてのファイルよりも優先され、ファイル内の同名の項目を上書きします。

上書き順序の概要

設定は優先度の低いものから高いものへとマージされ、優先度の高いものが低いものを上書きします。

オブジェクトはフィールドごとにディープマージされます。単一値は直接上書きされ、一部の配列（無効化/除外リストなど）は和集合マージされます。

セキュリティ上の理由から、プロジェクトレベルおよびローカルレベルの設定は、現在の作業ディレクトリが信頼されている場合にのみ適用されます。プロジェクト内の settings.json がまったく反映されない場合は、以下を確認してください。

現在のディレクトリが信頼されていることを確認します（security.folderTrust.enabled はデフォルトで有効です）。
信頼されていない場合は、ユーザーレベルの設定のみが読み込まれます。現在の作業ディレクトリの信頼は、起動時の信頼プロンプトによって決定されます（「現在のセッションのみ」または「覚える」を選択でき、後者は settings.local.json に書き込まれます）。また、グローバル settings で permissions.trustDirectories を使用して、よく使用するディレクトリを永続的に信頼することもできます。
/add-dir と --add-dir は、現在のセッションに対して追加の信頼済みディレクトリを追加するだけであり、信頼されていないプロジェクトディレクトリを信頼済みに変更することはできません。

構成ファイルは JSON 形式であり、// および /* */ のコメントが許可されています（解析前に除去されます）。よくあるエラーとしては、余分なカンマ、一致しない引用符、閉じられていない括弧などがあります。
ファイル先頭の BOM は自動的に無視されますが、BOM なしの UTF-8 として保存することをお勧めします。
エディターと JSON Schema（schemas/settings.schema.json）を活用して、検証と補完を利用してください。
フィールドは正しいグループの下に配置する必要があります（たとえば、トップレベルの theme ではなく ui.theme など）。
/settings パネルを使用して表示および変更すると、手動入力による形式エラーを防ぐことができます。