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

Neovim用GitLabプラグインのトラブルシューティングを行う際は、他のNeovimプラグインや設定から切り離して問題が発生することを確認する必要があります。まず、Neovimのテスト手順を実行し、次にGitLab Duoコード提案またはGitLab Duoコード提案 (Classic)のトラブルシューティング手順を実行してください。

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

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リモートを追加します。