この記事を開いてくださったこと、心から感謝しています。Pine Scriptで複数のインジケーターやストラテジーを作っていると、同じ計算を何度も書くことになり、「ライブラリにまとめて読み込むべきか、そのままコードを貼り付けるべきか」と迷った人も多いはずです。
結論から言うと、同じ関数を複数のスクリプトで使い回すならライブラリの読み込み、1つのスクリプトで完結させたいなら直接書く形が向いています。
この記事では、ライブラリの仕組み・importの書き方・バージョンの扱い・公開の決まり・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
Pine Scriptのライブラリとは、どんな仕組みなのか?
まずは、ライブラリの役割と、ふつうのスクリプトとの違いを整理します。
関数を使い回すための、公開された部品
TradingViewの公式ドキュメントによると、Pine Scriptのライブラリは、インジケーターやストラテジー、ほかのライブラリで再利用できる関数を含んだ、公開物です。計算の部品を、あちこちで使い回すための仕組みと考えると分かりやすくなります。
- 関数を使い回すための公開物
- インジケーターやストラテジーから使える
冒頭の宣言が、ふつうのスクリプトとは違う
公式ドキュメントでは、ライブラリは、冒頭にindicatorやstrategyではなく、libraryの宣言を書いて始めると説明されています。外から使える関数やメソッドなどが、そのライブラリの見える部分になります。
外に出す部品には、exportが必須
公式ドキュメントによると、外から使えるようにする関数には、exportというキーワードが必須です。exportを付けていない関数は、ほかのスクリプトからは使えません。公開したい部品だけに、exportを付けましょう。
- exportは必須のキーワード
- 付けた関数だけが外から使える
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
importは、どう書いて、どう使うのか?
ライブラリを読み込む書き方と、呼び出し方を確認します。
importは、作者名・ライブラリ名・バージョンで書く
公式ドキュメントでは、importの書き方は、作者名、ライブラリ名、バージョンを、スラッシュでつないで書く形です。この3つの組み合わせで、ライブラリが1つに特定されます。
- 作者名とライブラリ名とバージョンを書く
- 3つでライブラリが1つに決まる
asで、呼び出すときの名前を短くできる
公式ドキュメントによると、asのあとに別名を付けると、その別名が、関数を呼ぶときの名前の入り口になります。別名を付けなければ、ライブラリの名前が、そのまま使われます。名前が長いときは、別名で短くすると、読みやすくなります。
バージョンは、必ず自分で指定する
公式ドキュメントでは、バージョンは明示的に指定する必要があり、最新版を自動で使う方法はないと説明されています。ライブラリの作者が更新を公開するたびに、バージョンの番号は増えていきます。
- バージョンは必ず指定する
- 最新版が自動で使われることはない
更新があったとき、どう変わるのか?
ライブラリの更新を、利用する側がどう受け取るかを確認します。
新しいバージョンは、自分で番号を変えて取り込む
公式ドキュメントによると、作者が新しいバージョンを公開しても、使う側が、importの番号を書き換えるまでは、古いバージョンが使われ続けます。勝手に動きが変わらないのは、安心できる点です。
一方で、修正されたバグを取り込むには、自分で番号を変える手間が必要になります。
- 番号を書き換えるまで古いまま
- 勝手に動きが変わらない
10本のスクリプトで、手間の違いを計算する
同じ関数を使うスクリプトが10本あって、その関数のバグを直す場面を考えます。コードを直接書いている場合は、10本のコードを、1本ずつ直す必要があります。ライブラリを使っている場合は、ライブラリのコードを1回直して公開し、10本のimportの番号を書き換えます。
| 書き方 | コードを直す作業 | 番号を書き換える作業 |
|---|---|---|
| 直接書く | 10回 | 0回 |
| ライブラリ | 1回(公開) | 10回 |
※スクリプトが10本という仮定にもとづく、筆者の計算例です。
直す作業は減るが、書き換えはなくならない
この計算から分かるのは、ライブラリを使っても、書き換えの作業の数は、減らないということです。減るのは、コードの中身を直す作業の数で、ミスの起こりやすさが下がります。番号の書き換えは、数字を変えるだけなので、間違いにくい作業です。
- コードを直す回数が減る
- 書き換えは数字を変えるだけで済む
公開や再利用には、どんな決まりがあるのか?
公式ドキュメントが説明している、公開と再利用の決まりを確認します。
ライブラリは、公開してからでないと使えない
公式ドキュメントによると、ほかのスクリプトからimportするには、そのライブラリが、非公開または公開の形で、公開されている必要があります。また、すべてのライブラリは、オープンソースで公開されます。
- 公開してからimportできる
- ライブラリはオープンソースで公開される
公開するスクリプトは、公開のライブラリだけを使える
公式ドキュメントでは、公開するスクリプトは、公開のライブラリしか使えず、そのスクリプト自身も、オープンソースである必要があると説明されています。非公開のスクリプトなら、公開と非公開のどちらのライブラリも使えます。
| スクリプトの種類 | 使えるライブラリ |
|---|---|
| 公開のスクリプト | 公開のライブラリだけ |
| 非公開のスクリプト | 公開と非公開のどちらも |
※公式ドキュメントの説明をもとにした整理です。
他人のライブラリを使うときは、作者を明記する
公式ドキュメントによると、ライブラリのコードは、スクリプトの公開に関するハウスルールの上で、公共のものとして扱われます。オープンソースのスクリプトでの再利用に、作者の許可は不要ですが、作者を説明欄に明記する必要があります。

- 作者を説明欄に明記する
- オープンソースなら許可は不要
ライブラリの中に書けないことは、何か?
公式ドキュメントが示している、ライブラリ特有の制限を確認します。
exportした関数の中では、入力の関数が使えない
公式ドキュメントでは、外に出す関数は、inputで始まる入力の関数を呼べないと説明されています。ユーザーが設定を選ぶ部分は、使う側のスクリプトで作り、値を引数として渡す形になります。
- 入力の関数は呼べない
- 設定は使う側で作って渡す
グローバルの変数は、定数以外は使えない
公式ドキュメントによると、外に出す関数は、グローバルな変数を使えません。ただし、constの修飾子が付いた変数は使えます。配列や、入力で作った変数は、使えないものに含まれます。
アラートは、ライブラリから直接は作れない
外に出す関数の中で、alertの関数を呼ぶことはできますが、ライブラリから直接、チャート上のアラートを作ることはできません。アラートの設定は、使う側のスクリプトで行います。
使う側のスクリプトの種類については、Pine Scriptのインジケーターとストラテジーを比べた記事で整理しています。
- alertの関数は呼べる
- アラートは使う側で作る
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、ライブラリと直接書く方法の、どちらを選ぶとよいかの目安を整理します。
複数のスクリプトで使い回すなら、ライブラリ
同じ関数を、いくつものインジケーターやストラテジーで使うなら、ライブラリにまとめるのが向いています。直す場所が1つで済み、コードの食い違いが起きにくくなります。



- 直す場所が1つで済む
- コードの食い違いが起きにくい
1つで完結させたいなら、直接書く
1本のスクリプトで、完結させたいときは、直接書くほうが、シンプルです。ライブラリは、公開の手間がかかり、バージョンの管理も必要になります。1本だけで使う関数なら、直接書くほうが、手軽です。
- 公開やバージョンの管理が要らない
- 1本だけなら手軽に書ける
迷ったら、まず直接書いて、2本目から検討する
迷ったら、まず直接書いて試し、同じ関数を2本目のスクリプトでも使いたくなった時点で、ライブラリへの切り出しを検討しましょう。最初から、ライブラリにすると、公開の準備に時間がかかります。


運用で気をつけたいことは、何か?
ライブラリを使うときの、確認したい点をまとめます。
Pineのバージョンの違いにも、気をつける
Pine Script自体にも、バージョンがあります。バージョンの違いで書き方が変わる点は、Pine Scriptのバージョン5とバージョン6を比べた記事で整理しています。ライブラリを読み込むときは、ライブラリのバージョンと合わせて、確認しましょう。
- Pine自体のバージョンも確認する
- ライブラリのバージョンとあわせて見る
importの番号を、記録しておく
どのスクリプトが、どのライブラリの、どのバージョンを使っているかを、簡単にメモしておきましょう。更新があったときに、書き換える対象が、すぐに分かります。メモは、数行で十分です。
チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- どのスクリプトが何番を使うかをメモする
- 更新の対象がすぐ分かる
公開のスクリプトでは、使えるものに制限がある
自分のスクリプトを公開したいときは、公開のライブラリだけを使える点に、注意が必要です。非公開のライブラリを使ったスクリプトは、公開できない場合があります。公開する予定があるかを、最初に決めておきましょう。
- 公開するなら公開のライブラリだけを使う
- 公開の予定を先に決めておく
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ライブラリの数や大きさに、上限はあるのか?
公式ドキュメントのこのページでは、importできるライブラリの数や、ライブラリの大きさの上限は、説明されていません。実際の上限は、スクリプト全体の制限などに影響されることもあるため、最新の公式ドキュメントで確認しましょう。
ライブラリは、ほかのライブラリを読み込めるのか?
はい、読み込めます。公式ドキュメントでは、ライブラリが、ほかのライブラリや、自分自身の以前のバージョンを、importできると説明されています。部品を積み重ねて、使える形になっています。
- ほかのライブラリも読み込める
- 以前のバージョンも読み込める
まとめ:「Pine Scriptのライブラリのimportと直接記述、直す場所を1つにできる便利さと1本で完結する分かりやすさどっちを選ぶ?」
複数のスクリプトで同じ関数を使うならライブラリ、1本で完結させたいなら直接書く方法が向いています。迷ったら、まず直接書いて、2本目から切り出しを検討しましょう。
部品の使い方が分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










