ファイルの無視設定

.cursorignore と .cursorindexingignore でファイルアクセスを制御

概要

Cursor はプロジェクトのコードベースを読み取り・インデックス化して機能を提供する。ルートディレクトリの .cursorignore ファイルで、Cursor がアクセスできるディレクトリやファイルを制御できる。

Cursor は .cursorignore に記載されたファイルへのアクセスを次からブロックする:

• コードベースのインデックス化
• Tab、Agent、Inline Edit からアクセスできるコード
• @ 記号参照 経由でアクセスできるコード

Agent が開始するツール呼び出し（terminal や MCP サーバーなど）は、 .cursorignore の対象となるコードへのアクセスをブロックできない

なんでファイルを無視するの？

セキュリティ: APIキー、クレデンシャル、シークレットへのアクセスを制限。Cursorは無視対象のファイルをブロックするけど、LLMの予測不能性のために完全な保護が保証されるわけじゃない。

パフォーマンス: 大規模なコードベースやモノレポでは、関係ない部分を除外してインデックスを高速化し、ファイル発見の精度を上げよう。

グローバル無視ファイル

ユーザー設定で全プロジェクト共通の無視パターンを設定して、プロジェクトごとの設定なしで機密ファイルを除外できる。

デフォルトのパターンは次のとおり:

• 環境ファイル: **/.env, **/.env.*
• 資格情報: **/credentials.json, **/secrets.json
• 鍵: **/*.key, **/*.pem, **/id_rsa

.cursorignore の設定

ルートディレクトリに、.gitignore の構文で .cursorignore ファイルを作成しよう。

パターン例

config.json      # 特定のファイル
dist/            # ディレクトリ
*.log            # 拡張子
**/logs          # 入れ子のディレクトリ
!app/            # 無視ルールの否定（無視しない）

階層的な無視

親ディレクトリの .cursorignore を検索するには、Cursor Settings > Features > Editor > Hierarchical Cursor Ignore を有効にしてね。

メモ: コメントは # で始まるよ。後に書かれたパターンが前のパターンを上書きするよ。パターンはファイルの位置を基準にした相対指定だよ。

.cursorindexingignore でインデックスを制限する

.cursorindexingignore を使うと、インデックス化からのみファイルを除外できる。これらのファイルは AI 機能からは引き続きアクセスできるけど、コードベース検索には表示されない。

デフォルトで無視されるファイル

Cursor は .gitignore と、以下のデフォルトの無視リストにあるファイルを自動的に無視する。.cursorignore では ! を先頭につけてオーバーライドできる。

Default Ignore List

インデックス作成時のみ、.gitignore、.cursorignore、.cursorindexingignore に加えて、次のファイルが無視される:

package-lock.json
pnpm-lock.yaml
yarn.lock
composer.lock
Gemfile.lock
bun.lockb
.env*
.git/
.svn/
.hg/
*.lock
*.bak
*.tmp
*.bin
*.exe
*.dll
*.so
*.lockb
*.qwoff
*.isl
*.csv
*.pdf
*.doc
*.doc
*.xls
*.xlsx
*.ppt
*.pptx
*.odt
*.ods
*.odp
*.odg
*.odf
*.sxw
*.sxc
*.sxi
*.sxd
*.sdc
*.jpg
*.jpeg
*.png
*.gif
*.bmp
*.tif
*.mp3
*.wav
*.wma
*.ogg
*.flac
*.aac
*.mp4
*.mov
*.wmv
*.flv
*.avi
*.zip
*.tar
*.gz
*.7z
*.rar
*.tgz
*.dmg
*.iso
*.cue
*.mdf
*.mds
*.vcd
*.toast
*.img
*.apk
*.msi
*.cab
*.tar.gz
*.tar.xz
*.tar.bz2
*.tar.lzma
*.tar.Z
*.tar.sz
*.lzma
*.ttf
*.otf
*.pak
*.woff
*.woff2
*.eot
*.webp
*.vsix
*.rmeta
*.rlib
*.parquet
*.svg
.egg-info/
.venv/
node_modules/
__pycache__/
.next/
.nuxt/
.cache/
.sass-cache/
.gradle/
.DS_Store/
.ipynb_checkpoints/
.pytest_cache/
.mypy_cache/
.tox/
.git/
.hg/
.svn/
.bzr/
.lock-wscript/
.Python/
.jupyter/
.history/
.yarn/
.yarn-cache/
.eslintcache/
.parcel-cache/
.cache-loader/
.nyc_output/
.node_repl_history/
.pnp.js/
.pnp/

否定パターンの制限

否定パターン（先頭に !）を使う場合、親ディレクトリが * で除外されていると、その配下のファイルを再度含め直すことはできない。

# public フォルダ内のすべてのファイルを無視
public/*

# ✅ これは動作する（ファイルがトップレベルにあるため）
!public/index.html

# ❌ これは動作しない — ネストされたディレクトリ内のファイルは再包含できない
!public/assets/style.css

回避策: ネストされたディレクトリを明示的に除外する:

public/assets/*
!public/assets/style.css # このファイルは参照できるようになる

除外されたディレクトリはパフォーマンスのために走査されないため、配下ファイルへのパターンは効果がない。
これは、ネストされたディレクトリにおける否定パターンの .gitignore の挙動と一致する。詳しくは gitignore パターンに関する公式 Git ドキュメント を参照。

トラブルシューティング

git check-ignore -v [file] でパターンをテストしてみよう。