Bitbucket search syntax
This page explains Bitbucket Data Center and Server's search syntax to help you find exactly what you're looking for.
考慮事項
検索の実行ではいくつかの制限事項があります。
- Searches may include "." and "_", but all other punctuation characters are ignored. (e.g.
!"#$%&'()*+,-/:;<=>?@[\]^`{|}~) - To search for multiple words in exact order, put them in quotes (e.g.
"find this phrase"). As with other queries, all punctuation except "." and "_" is ignored (e.g."find-this-phrase"effectively searches for"find this phrase"). - Only the default branch is searchable (for most repositories the default branch will be
masterormain). - Wildcard searches (e.g.
qu?ck buil*) and regular expressions in queries are not supported. - Single characters within search terms are ignored as they’re not indexed by Bitbucket for performance reasons (e.g. searching for “foo a bar” is the same as searching for just “foo bar” as the character “a” in the search is ignored).
- 大文字と小文字は区別されません (ただし、検索演算子はすべて大文字にする必要があります)。
- クエリには最大で 9 つの式 (単語と演算子の組み合わせ) を設定できます。
- クエリの長さを 250 文字以上にすることはできません。
- 512 KiB 未満のファイルのみを検索できます。
閲覧権限を持っているコードのみが検索結果に表示されます。
A query in Bitbucket has to contain at least one search term, which can either be a single word or a phrase surrounded by quotes.
演算子
検索演算子は、検索に追加できる、検索結果の絞り込みに役立つ単語です。演算子はすべて大文字にする必要があります。ファイルの検索には次の検索演算子を使用できます。
ANDORNOT-( )
Multiple terms can be used, and they form a boolean query that implicitly uses the AND operator. So a query for "bitbucket server" is equivalent to "bitbucket AND server".
| 用語 | クエリ例 | 用途 |
|---|---|---|
AND | bitbucket AND server | Matches files that contain both "bitbucket" and "server". |
OR | bitbucket OR server | Matches files that contain either "bitbucket" or "server" (or both). |
NOT | bitbucket NOT jira | Matches files that contain "bitbucket" but don't contain "jira". |
- | bitbucket -jira | Use before a term, matches files that contain "bitbucket" but don't contain "jira". |
( ) | bitbucket AND (server OR cloud) | Matches files that contain " |
修飾子
Modifiers can be used to further restrict search results. Use a modifier in the form "key:value". If there are multiple modifiers in a query they are implicitly combined using "AND" and apply to the whole search expression. These are the search modifiers that can be used to search for files.
リポジトリおよびプロジェクト修飾子
repo: <reponame> or repository: <reponame>
Search within a particular repository. Must be used with a project: modifier.
| 用語 | クエリ例 | 用途 |
|---|---|---|
repo: |
または
または
| Matches files within the "bitbucket" repository within the "atlassian" project that contain the term "jira". |
project: <プロジェクト キー / 名前>
特定のプロジェクト内のすべてのリポジトリで、検索語を検索します。
| 用語 | クエリ例 | 用途 |
|---|---|---|
project: |
| Matches files within the "atlassian" project that contain the term "jira". |
パス修飾子
path: <directory or file name>
Restrict search to only consider files with the search term in their path.
| 用語 | クエリ例 | 用途 |
|---|---|---|
| react path:frontend | Matches files within directories named frontend containing the term react. |
react path:frontend/*/package.lock | Matches package.lock files within directories named frontend containing the term react. |
言語およびファイル拡張子の修飾子
lang: or language: <language>
Code search can be restricted to only consider a particular language or a particular file extension. For some languages adding a lang criteria is equivalent to specifying the file extension. For example, "lang:java" is equivalent to "ext:java". For other languages multiple file extensions are mapped to a single language. For example, ".hs", ".lhs" and ".hs-bootare" file extensions are used for the Haskell programming language, and will be matched when specifying "lang:haskell".
| 用語 | クエリ例 | 用途 |
|---|---|---|
lang: |
または
| Matches files that contain the term "jira" within Java files, files with .java, .class, or .jar extension. |
ext: or extension: <file extension>
| 用語 | クエリ例 | 用途 |
|---|---|---|
ext: |
または
| Matches files that contain the term "jira" within Haskell files with the .lhs extension. |
フォーク修飾子
fork: <true or false>
リポジトリの検索結果をフォークかどうかに基づいて除外します。
| 用語 | クエリ例 | 用途 |
|---|---|---|
fork: | fork:true | フォークであるリポジトリからの結果のみを含めます。 |
fork:false | フォークではないリポジトリからの結果のみを含めます。 |