Neovimのトラブルシューティング

Neovim用のGitLabプラグインのトラブルシューティングを行う場合、イシューが他のNeovimプラグインや設定とは切り離して発生するかどうかを確認する必要があります。まず、Neovimのテスト手順を実行し、次にGitLab Duoコード提案のトラブルシューティング手順を実行します。

このページのステップで問題が解決しない場合は、Neovimプラグインのプロジェクトにあるオープンなイシューのリストを確認してください。イシューが問題と一致する場合は、そのイシューを更新してください。お客様の問題と一致するイシューがない場合は、新しいイシューを作成してください。

GitLab Duoコード提案の拡張機能のトラブルシューティングについては、コード提案のトラブルシューティングを参照してください。

Neovimの設定をテストする

Neovimプラグインのメンテナーは、トラブルシューティングの一環として、これらのチェックの結果を求めることがよくあります:

ヘルプタグが生成されていることを確認してください。
:checkhealthを実行します。
デバッグログを有効にします。
最小限のプロジェクトで問題を再現してみてください。

ヘルプタグを生成する

エラーE149: Sorry, no help for gitlab.txtが表示された場合は、Neovimでヘルプタグを生成する必要があります。この問題を解決するには、以下を実行します:

次のいずれかのコマンドを実行します:
- :helptags ALL
- プラグインのルートディレクトリから:helptags doc/。

`:checkhealth`を実行する

:checkhealth gitlab*を実行して、現在のセッション設定の診断を取得します。これらのチェックは、設定に関する問題を特定し、自分で解決するのに役立ちます。

デバッグログを有効にする

デバッグログファイルを有効にして、問題に関する詳細な情報をキャプチャします。デバッグログファイルには機密情報を含むワークスペースの設定が含まれている可能性があるため、出力を確認してから他のユーザーと共有してください。

追加のロギングを有効にするには:

現在のバッファで、vim.lspログレベルを設定します:
```
:lua vim.lsp.set_log_level('debug')
```

最小限のプロジェクトで問題を再現する

プロジェクトのメンテナーがお客様の問題を理解して解決できるように、お客様の問題を再現するサンプル設定またはプロジェクトを作成してください。たとえば、コード提案に関する問題をトラブルシューティングする場合:

サンプルプロジェクトを作成する:

mkdir issue-25
cd issue-25
echo -e "def hello(name)\n\nend" > hello.rb

次の内容で、minimal.luaという名前の新しいファイルを作成します:

-- NOTE: Do not set this in your usual configuration, as this log level
-- could include sensitive workspace configuration.
vim.lsp.set_log_level('debug')

vim.opt.rtp:append('$HOME/.local/share/nvim/site/pack/gitlab/start/gitlab.vim')

vim.cmd('runtime plugin/gitlab.lua')

-- gitlab.config options overrides:
local minimal_user_options = {}
require('gitlab').setup(minimal_user_options)

最小限のNeovimセッションで、hello.rbを編集します:
```
nvim --clean -u minimal.lua hello.rb
```
発生した動作を再現してみてください。必要に応じて、minimal.luaまたはその他のプロジェクトファイルを調整します。
~/.local/state/nvim/lsp.logで最近のエントリを表示し、関連する出力をキャプチャします。
glpat-で始まるトークンなど、機密情報への参照を削除します。
Vimのレジスタまたはログファイルから機密情報を削除します。

エラー: `GCS:unavailable`

このエラーは、ローカルプロジェクトが.git/configでリモートを設定していない場合に発生します。

この問題を解決するには、git remote addを使用して、ローカルプロジェクトにGitリモートを追加します。