Langkau ke kandungan utama

Pasang Qiskit SDK dan Qiskit Runtime dari sumber

Memasang Qiskit SDK dari sumber membolehkan anda mengakses versi pembangunan semasa, berbanding menggunakan versi dalam repositori Python Package Index (PyPI). Ini membolehkan anda memeriksa dan melanjutkan versi terkini kod Qiskit dengan lebih cekap.

Cipta dan aktifkan persekitaran maya baharu​

  1. Navigasi ke direktori projek anda dan cipta persekitaran minimal yang hanya mengandungi Python.

    python3 -m venv .venv

  2. Aktifkan persekitaran baharu anda.

    source .venv/bin/activate

Pasang pengkompil Rust​

Pengkompil Rust mesti dipasang pada sistem anda untuk mengkompil Qiskit. Untuk memasang pengkompil Rust, gunakan pemasang Rust merentas platform rustup atau kaedah pemasangan lain.

Pasang Qiskit​

Ikut langkah-langkah ini untuk memasang Qiskit:

  1. Klon repositori Qiskit.
git clone https://github.com/Qiskit/qiskit.git
  1. Tukar ke direktori qiskit.
cd qiskit
  1. (Pilihan) Jika anda ingin menjalankan ujian atau semakan linting, pasang keperluan pembangun.
pip install -r requirements-dev.txt
  1. Pasang qiskit.

  • Pemasangan standard:

    pip install .

  • Mod boleh sunting: Dalam mod ini, anda tidak perlu memasang semula Qiskit apabila ada perubahan kod pada projek.

    pip install -e .

    Dalam mod boleh sunting, sambungan yang dikompil dibina dalam mod nyahpepijat tanpa pengoptimuman. Ini mempengaruhi prestasi runtime kod yang dikompil. Untuk membina sambungan yang dikompil dengan pengoptimuman diaktifkan, jalankan arahan berikut untuk membina semula binari dalam mod keluaran:

    python setup.py build_rust --release --inplace
    nota

    Jika anda sedang mengerjakan kod Rust dalam Qiskit, anda perlu membina semula kod sambungan setiap kali anda membuat perubahan setempat. Dalam mod boleh sunting, sambungan Rust hanya dibina apabila arahan pasang dijalankan, jadi perubahan setempat yang anda buat pada kod Rust tidak tercermin dalam pakej yang dipasang melainkan anda membina semula sambungan dengan menjalankan semula build_rust (dengan atau tanpa --release, bergantung pada sama ada anda ingin membina dalam mod keluaran atau nyahpepijat).

Pasang Qiskit Runtime​

Ikut langkah-langkah ini jika anda ingin memasang Qiskit Runtime:

  1. Klon repositori Qiskit Runtime.
git clone https://github.com/Qiskit/qiskit-ibm-runtime.git
  1. Tukar ke direktori qiskit-ibm-runtime.
cd qiskit-ibm-runtime
  1. Pasang qiskit-runtime. Kami mengesyorkan menggunakan persekitaran maya untuk mengelakkan pencemaran pemasangan Python global anda.

  • Pemasangan standard:

    pip install .

  • Mod boleh sunting: Dalam mod ini, anda tidak perlu memasang semula Qiskit apabila ada perubahan kod pada projek.

    pip install -e .

    Dalam mod boleh sunting, sambungan yang dikompil dibina dalam mod nyahpepijat tanpa pengoptimuman.

  1. (Pilihan) Jika anda ingin menjalankan ujian atau semakan linting, pasang keperluan pembangun. Kami mengesyorkan menggunakan persekitaran maya untuk mengelakkan pencemaran pemasangan Python global anda.
pip install -e ".[dev]"

Langkah seterusnya​

Cadangan
Source: IBM Quantum docs — updated 12 Mac 2026
English version on doQumentation — updated 7 Mei 2026
This translation based on the English version of 11 Mac 2026