DataSpell 2025.3 ヘルプ

Git リポジトリのセットアップ

既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョンコントロール下に置くと、DataSpell はコンピューターに Git がインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。

DataSpell は、Windows10 バージョン 2004(英語) で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。

Git が Windows にインストールされていない場合、DataSpell は WSL で Git を検索し、そこから使用します。また、\\wsl$ パスを使用すると開かれるプロジェクトの場合、DataSpell は WSL から Git に自動的に切り替わります。

WSL から Git を使用するように DataSpell を手動で構成する必要がある場合は、バージョン管理 | Git 設定ページ Ctrl+Alt+S に移動し、Git 実行可能ファイルのパスフィールドの参照アイコンをクリックして、\wsl$ パス (例: \\wsl$\debian\usr\bin\git) を介して WSL から Git を選択します。

リモートホストからプロジェクトをチェックアウトする (git クローン)

DataSpell を使用すると、既存のリポジトリをチェックアウト (Git 用語ではクローン ) し、ダウンロードしたデータに基づいて新しいプロジェクトを作成できます。

  1. Git リポジトリのクローン作成を開始するには、次のいずれかを実行します。

    • バージョン管理統合がすでに有効になっている場合は、Git | クローンに進みます。

    • バージョン管理統合がまだ有効になっていない場合は、VCS | バージョン管理から取得に進みます。

      あるいは、ファイル | 新規 | バージョン管理からプロジェクトに進みます。

    • 現在開いているプロジェクトがない場合は、ウェルカム画面でリポジトリのクローンをクリックします。

  2. リポジトリのクローンダイアログで、クローンを作成するリモートリポジトリの URL を指定するか、左側で VCS ホスティングサービスの 1 つを選択します。

    選択したホスティングサービスにすでにログインしている場合は、完了すると、複製できる利用可能なリポジトリのリストが表示されます。

    限定された履歴で浅いクローン(英語)を実行する場合は、履歴が切り捨てられた浅いクローンチェックボックスを選択し、クローンするコミットの数を指定します。

    メインメニューで Git | 浅いリポジトリを選択すると、後で残りの履歴を取得できます。

  3. クローンをクリックします。複製したソースに基づいてプロジェクトを作成する場合は、確認ダイアログではいをクリックします。Git ルートマッピングは、プロジェクトのルートディレクトリに自動的に設定されます。

    プロジェクトにサブモジュール(英語)が含まれている場合、それらも複製され、プロジェクトルートとして自動的に登録されます。

  4. プロジェクト '<project_name>' を信頼して開きますか ? プロジェクトセキュリティダイアログで、プロジェクトを開く方法を選択します: プロジェクトを信頼またはセーフモードでプレビュー

既存のプロジェクトを Git バージョン管理下に置く

既存のプロジェクトソースに基づいてローカル Git リポジトリを作成できます。

プロジェクトまたはワークスペースディレクトリを Git リポジトリに関連付けます

  1. Git に配置するプロジェクトまたはワークスペースディレクトリを開きます。

  2. Alt+` を押して VCS 操作のポップアップを開き、VCS 連携を有効にするを選択します。

    あるいは、VCS | VCS 連携を有効にするに進みます。

  3. バージョン管理システムとして Git を選択し、OK をクリックします。

    プロジェクト全体が単一の Git ディレクトリに関連付けられるため、各ファイルを Git ディレクトリに個別に追加する必要はありません。

  4. Git 統合を有効にすると、DataSpell は Git 経由でプロジェクト設定ファイルを共有するかどうかを確認します。常に追加を選択すると、DataSpell で作業する他のリポジトリユーザーとプロジェクト設定を同期できます。

    Notification prompting to select how to treat configuration files

プロジェクトの Git リポジトリを初期化した後、プロジェクトファイルをリポジトリに追加する必要があります。

ローカルリポジトリにファイルを追加する

  1. コミットツールウィンドウ Alt+0 で、バージョン管理外ファイルノードを展開します。

  2. Git または変更リスト全体に追加するファイルを選択し、Ctrl+Alt+A を押すか、コンテキストメニューから VCS に追加を選択します。

    ワークスペースツールウィンドウ Alt+1 からローカル Git リポジトリにファイルを追加することもできます。追加するファイルを選択し、Ctrl+Alt+A を押すか、コンテキストメニューから Git | 追加を選択します。

プロジェクトまたはワークスペースディレクトリで Git 統合が有効になっている場合、DataSpell は、DataSpell の外部から追加されたファイルであっても、新しく作成されたファイルを Git に追加するよう提案します。この動作は、バージョン管理 | 確認設定ページ(Ctrl+Alt+S)で変更できます。特定のファイルを常にバージョン管理しないままにしたい場合は、無視することができます。

バージョン管理からファイルを除外する (無視)

特定のファイルをバージョン管理しないでおく必要がある場合があります。これらには、VCS 管理ファイル、ユーティリティのアーティファクト、バックアップコピーなどがあります。DataSpell を介してファイルを無視することができ、IDE はそれらを Git に追加することを提案せず、無視されたものとしてハイライトします。

無視できるのは、バージョン管理されていないファイル、つまりバージョン管理外ファイル変更リストにあるファイルのみです。ファイルが Git に追加されてコミットされていない場合は、コミットウィンドウでファイルを右クリックし、ロールバックを選択できます。

Git では、2 種類の構成ファイルで無視されたファイルパターンをリストできます。

  • .git/info/exclude ファイル。

    このファイルにリストされているパターンは、リポジトリのローカルコピーにのみ適用されます。

    このファイルは、Git リポジトリを初期化またはチェックアウトすると自動的に作成されます。

  • VCS ルートディレクトリとそのサブディレクトリにある 1 つ以上の .gitignore ファイル。

    これらのファイルはリポジトリにチェックインされるため、ファイル内の無視パターンをチーム全体が利用できるようになります。無視されたファイルパターンを保存する最も一般的な場所です。

    VCS ルートディレクトリに .gitignore ファイルがない場合、ワークスペースツールウィンドウの任意の場所を右クリックし、新規 | ファイルを選択して、新規ファイルダイアログに .gitignore と入力します。

ファイルを .gitignore または .git/info/exclude に追加する

  1. ファイルを無視するために使用する Git 構成ファイルの種類を決定します。疑わしい場合は、.gitignore を使用してください。

  2. コミットウィンドウまたはワークスペースツールウィンドウ Alt+1 で、無視するバージョン管理されていないファイルまたはフォルダーを見つけます。これらのビューのファイルの色は、ファイルのステータスを識別できます。

  3. 選択項目を右クリックし、Git | .gitignore に追加するまたは Git | .git/info/exclude に追加を選択します。

    これらのビューのファイルの色は、ファイルのステータスを識別できます。

特定のパターンまたはタイプによってファイルを除外する必要がある場合は、.gitignore または .git/info/exclude ファイルを直接編集できます。.gitignore パターンフォーマット(英語)を参照してください。

リモートリポジトリを追加する

ローカルソースに基づいて Git リポジトリを作成した場合は、コードベース全体をローカルに保存するリスクを排除するだけでなく、Git プロジェクトで共同作業できるようにリモートリポジトリを追加する必要があります。作業を共有し、そこからデータを取得して、他のコントリビューターが行った変更をローカルリポジトリバージョンに統合する必要がある場合は、変更をリモートリポジトリにプッシュします

たとえば、GitHub(英語) からリモート Git リポジトリを複製した場合、リモートは自動的に構成され、それと同期するときに指定する必要はありません。Git がクローン元のリモートに付けるデフォルト名は、origin です。

リモートを定義する

  1. Git ホスティング(Bitbucket(英語)GitHub(英語)GitLab(英語) など)に空のリポジトリを作成します。DataSpell を移動せずに、GitHub または GitLab にリポジトリを作成できます。GitHub でプロジェクトを共有するGitLab でプロジェクトを共有するを参照してください。

  2. メインメニューから Git | プッシュを選択してコミットをプッシュする準備ができたら、プッシュダイアログを起動するか、Ctrl+Shift+K をプッシュします。

  3. 開いたダイアログで、リモートの名前とホストする URL を指定します。

    リモートを取得オプションを選択すると、ブランチリストとコミット履歴もすぐに取得されます

2 台目のリモートを追加

場合によっては、2 番目のリモートリポジトリも追加する必要があります。これは、たとえば、書き込みアクセス権を持たないリポジトリのクローンを作成し、元のプロジェクトの独自のフォークに変更をプッシュする場合に便利です。もう 1 つの一般的なシナリオは、他人のプロジェクトフォークである独自のリポジトリのクローンを作成し、元のプロジェクトと同期してそこから変更を取得する必要があるというものです。

  1. メインメニューで、Git | リモートの管理に移動します。Git リモートダイアログが開きます。

  2. ツールバーの追加 add ボタンをクリックするか、Alt+Insert を押してください。

  3. 表示されたダイアログで、リモートの名前と URL を指定し、OK をクリックします。

このビデオからさらに詳しく学ぶ:

Git リモートのパスワードを設定する

リモート Git リポジトリと対話するたびに(たとえば、プル更新、またはプッシュ操作中)、許可が必要です。パスワードを記憶するように DataSpell を構成できるため、許可が必要になるたびに資格情報を指定する必要はありません。

パスワードポリシーを設定する

  1. 設定ダイアログ Ctrl+Alt+S で、左側の外観 & 振る舞い | システム設定 | パスワードを選択します。

  2. DataSpell が Git リモートリポジトリのパスワードを処理する方法を選択します。

    • ネイティブキーチェーンを使用する : ネイティブのキーチェーンを使用してパスワードを保存するには、このオプションを選択します。この設定は、macOS および Linux でのみ使用できます。

    • KeePass を使用する : KeePass パスワードマネージャー(英語)を使用してパスワードを保存するには、このオプションを選択します。KeePass パスワードマネージャーを使用する場合、個別のパスワードを保存するファイルにアクセスするためにマスターパスワードが使用されます。DataSpell がパスワードを記憶すると、パスワードデータベースにアクセスする必要がない限り、パスワードを要求されなくなります。c.kdbx ファイルへのアクセスに使用するパスワードを MasterPassword フィールドに入力します。

      データベースフィールドで、c.kdbx ファイルのデフォルトの場所を変更することができます。

      c.kdbx ファイルをインポートするには、the Settings icon をクリックしてドロップダウンメニューからインポートを選択するか、the Browse button をクリックしてパスワードを含むローカルファイルへのパスを指定します。

      既存のパスワードをデータベースから削除する場合は、クリアを選択します。

    • 保存せずに再起動後にパスワードを忘れる : DataSpell を閉じた後にパスワードをリセットしたい場合は、このオプションを選択してください。

2025 年 11 月 20 日

関連ページ:

セキュリティ

潜在的なセキュリティリスクを防ぐために、DataSpell では、プロジェクトのソースがわからない場合にプロジェクトを開く方法を決定できます。DataSpell は、オープニングプロセス中に実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:リモートディレクトリをアタッチまたはクローンして開くと、DataSpell では、未知ソースコードを含むプロジェクトの処理方法をすぐに決定できます。プロジェクトを初めて開くたびに、IDE...

Git リポジトリに変更をコミットしてプッシュする

Git リポジトリに新しいファイルを追加するか、すでに Git バージョン管理下にあるファイルを変更し、現在の状態に満足したら、作業の結果を共有できます。これには、ローカルにコミットしてリポジトリのスナップショットをプロジェクト履歴に記録し、次にリモートリポジトリにプッシュして他のユーザーが使用できるようにすることが含まれます。Git ユーザー名を設定する Git は、コミットを ID に関連付けるために、ユーザー名を知っている必要があります。ユーザー名を設定していない場合、DataSpell は...

ファイルを Git に追加し、変更を追跡する

Git にファイル追加コミットツールウィンドウを開きます。を押すか、コンテキストメニューから VCS に追加を選択して、バージョン管理外ファイル変更リスト内のファイルをバージョン管理下に置きます。変更リスト全体を追加することも、個別のファイルを選択することもできます。プロジェクトで Git 統合を有効にしている場合、DataSpell は、新しく作成された各ファイルをバージョン管理下に追加することを提案します。この動作は、の設定ダイアログで変更できます。特定のファイルを常にバージョン管理しない...

リモート Git リポジトリと同期する (フェッチ、プル、更新)

変更をアップストリームにプッシュして作業結果を共有する前に、リモートリポジトリと同期して、プロジェクトのローカルコピーが最新であることを確認する必要があります。これを行うには、次のいずれかの方法があります: 変更のフェッチ、変更のプル、プロジェクトの更新 Git ブランチポップアップには、まだフェッチされていない受信コミットの数 (ブランチの名前の横にある青い矢印アイコン) と送信コミットの数 (ブランチの名前の横にある緑の矢印アイコン) が示されます。変更のフェッチ:アップストリームから変更をフェ...

GitHub でホストされているディレクトリを管理する

ディレクトリをチェックアウトする (クローン):DataSpell から直接貢献したいリポジトリを複製し、それに基づいて新しいディレクトリを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の場合は、...

GitLab でホストされているプロジェクトを管理する

GitLab プロジェクトのクローンを作成する:貢献したい GitLab プロジェクトを DataSpell から直接複製し、それに基づいて新しいプロジェクトを作成できます。プロジェクトのクローンを作成する前に、GitLab アカウントにログインしていることを確認してください。いずれかのオプションを使用して、リポジトリのクローンダイアログを開きます。に移動します。すでにプロジェクトを開いている場合は、に進みます。ウェルカム画面で、リポジトリのクローンボタンをクリックします。、クローンを作成するプ...