Gabay sa pyenv: Bersyon ng Python at Virtual na Kapaligiran

1 1. Ano ang pyenv?
2 2. Paraan ng Pag-install ng pyenv
3 3. Pamamahala ng Bersyon ng Python
4 4. Pagsasama ng virtualenv
5 5. Mga Dapat Tandaan Kapag Gumagamit ng pyenv
6 6. Buod at Susunod na Hakbang
- 6.1 Buod ng Paggamit ng pyenv
- 6.2 Susunod na Hakbang

1. Ano ang pyenv?

Para sa mga developer ng Python, madalas na kailangan nilang gumamit ng iba’t ibang bersyon ng Python para sa bawat proyekto. Sa ganitong sitwasyon, kapaki-pakinabang ang “pyenv”. Ang pyenv ay isang tool na nag-aayos ng maraming bersyon ng Python at nagpapahintulot na madaling palitan ang bersyon ayon sa proyekto.

Mga Hamon sa Pamamahala ng Bersyon ng Python

Habang nagpapatuloy ang pag-develop ng Python, maaaring kailanganin ang iba’t ibang bersyon ng Python sa maraming proyekto. Halimbawa, sa isang proyekto ay gumagamit ng Python 3.9, habang sa isa pang proyekto ay kailangan ang Python 2.7. Karaniwan, iisang bersyon lamang ng Python ang naka-install sa system, kaya nagiging magulo ang pagpapalit ng bersyon. Ang pyenv ang solusyon sa problemang ito.

Mga Benepisyo ng pyenv

pyenv ay nagbibigay ng mga sumusunod na benepisyo:

Madaling pagpapalit ng bersyon: Sa paggamit ng pyenv, madaling mapalitan ang bersyon ng Python sa buong system o sa bawat proyekto.
Pamamahala ng maraming bersyon: Maaaring pamahalaan ang maraming bersyon ng Python na naka-install sa system gamit ang isang command. Dahil dito, madaling tugunan ang mga dependency at pagkakaiba ng bersyon sa bawat proyekto.
Suporta sa maraming OS maliban sa Windows: Magagamit sa iba’t ibang OS tulad ng macOS at Linux.

Paano gumagana ang pyenv

Ang pyenv ay lumilikha ng hiwalay na direktoryo para sa bawat bersyon ng Python at ini-install doon ang bawat bersyon. Maaaring gamitin ng mga gumagamit ang mga command na pyenv global at pyenv local upang tukuyin kung aling bersyon ang gagamitin sa buong system o sa isang partikular na proyekto.

2. Paraan ng Pag-install ng pyenv

Buod

pyenv upang magamit, kailangan muna itong i-install sa system. Sa seksyong ito, ipapaliwanag ang mga hakbang sa pag-install ng pyenv para sa macOS at Linux. Sa Windows environment, hindi sinusuportahan ang pyenv, kaya inirerekomenda ang paggamit ng ibang paraan (tulad ng WSL o Anaconda).

Mga Hakbang sa Pag-install sa macOS

Sa macOS, maaaring madaling i-install ang pyenv gamit ang Homebrew. Ang Homebrew ay isang package manager para sa macOS, isang maginhawang tool na nagpapahintulot sa madaling pag-install ng iba’t ibang software. Sundin ang mga hakbang sa ibaba upang magpatuloy sa pag-install.

Pag-verify ng Pag-install ng Homebrew Una, tiyakin kung naka-install na ang Homebrew sa system. Buksan ang terminal at patakbuhin ang sumusunod na utos.

   brew --version

Kung lumabas ang impormasyon ng bersyon, naka-install na ang Homebrew. Kung hindi pa ito naka-install, bisitahin ang opisyal na site (Opisyal na Site ng Homebrew) upang tingnan ang mga hakbang sa pag-install.

Pag-install ng pyenv Kung naka-install na ang Homebrew, patakbuhin ang sumusunod na utos upang i-install ang pyenv.

   brew install pyenv

Kapag natapos na ang pag-install, magpatuloy sa susunod na hakbang.

Pagsasaayos ng Environment Variables Upang magamit ang pyenv, kailangan mong i-set ang mga environment variable ng shell. Karaniwan itong idinadagdag sa .bash_profile o .zshrc. Patakbuhin ang mga sumusunod na utos sa terminal upang i-set ang mga variable.

   echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
   echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
   echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile

Kung gumagamit ka ng .zshrc, idagdag ang mga linyang ito sa .zshrc imbes na sa .bash_profile. Pagkatapos maayos ang mga setting, i-restart ang terminal o patakbuhin ang sumusunod na utos upang i-apply ang mga pagbabago.

   source ~/.bash_profile

Pag-verify ng Pag-install Kapag tapos na ang mga setting, patakbuhin ang sumusunod na utos upang tiyakin na tama ang pag-install ng pyenv.

   pyenv --version

Kung lumabas ang numero ng bersyon, tama ang pag-install ng pyenv.

Mga Hakbang sa Pag-install sa Linux

Sa Linux environment, maaari ring i-install ang pyenv gamit ang halos parehong hakbang tulad ng sa macOS, ngunit karaniwang ginagamit ang mga package manager tulad ng apt o yum. Narito ang mga hakbang para sa Ubuntu.

Pag-install ng Mga Kailangan na Package Bago i-install ang pyenv, kailangan munang i-install ang mga dependency package. Patakbuhin ang sumusunod na utos upang i-install ang mga kinakailangang tool.

   sudo apt update
   sudo apt install -y build-essential libssl-dev zlib1g-dev libbz2-dev 
   libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev 
   xz-utils tk-dev libffi-dev liblzma-dev python-openssl git

Pag-install ng pyenv Gamit ang Git, i-clone ang repository ng pyenv at i-install ito.

   curl https://pyenv.run | bash

Pagsasaayos ng Environment Variables Upang paganahin ang pyenv, idagdag ang mga sumusunod na setting sa .bashrc o .zshrc.

   export PATH="$HOME/.pyenv/bin:$PATH"
   eval "$(pyenv init --path)"

Upang ma-apply ang mga setting, i-restart ang terminal o patakbuhin ang source ~/.bashrc.

Pag-verify ng Pag-install Patakbuhin ang sumusunod na utos upang tiyakin na tama ang pag-install ng pyenv.

   pyenv --version

Pag-troubleshoot

Kung may error na lumitaw habang ini-install ang pyenv, maaaring kulang ang mga dependency library. Lalo na sa Linux, maaaring kailanganin ng iba’t ibang library depende sa system, kaya sumangguni sa opisyal na dokumentasyon upang i-install ang tamang mga library.

3. Pamamahala ng Bersyon ng Python

pyenv Pagkatapos i-install, kailangan mong matutunan kung paano pamahalaan ang mga bersyon ng Python. Sa seksyong ito, gagamitin ang pyenv para i-install at palitan ang mga bersyon ng Python.

Pag-install ng Bersyon ng Python

Sa pyenv, madaling mag-install ng iba’t ibang bersyon ng Python. Halimbawa, kung nais mong gamitin ang Python 3.8 para sa isang proyekto at Python 3.9 para sa iba, maaari mong i-install ang bawat bersyon tulad ng ipinapakita.

Pag-verify ng Listahan ng Bersyon Una, tingnan ang listahan ng mga magagamit na bersyon ng Python sa pyenv. Sa pamamagitan ng sumusunod na utos, ipapakita ang lahat ng maaaring i-install na bersyon.

   pyenv install --list

Sa ganitong paraan, ipapakita ng pyenv ang lahat ng suportadong bersyon ng Python, at maaari mong piliin ang kinakailangang bersyon.

Pag-install ng Bersyon ng Python Upang mag-install ng partikular na bersyon, gamitin ang sumusunod na utos.

   pyenv install 3.9.1

Ang utos na ito ay mag-iinstall ng Python 3.9.1 sa system. Kung kailangan mo ng maraming bersyon, i-install ang bawat isa nang hiwalay.

Pagpapalit ng Bersyon ng Python

Sa pamamagitan ng pyenv, madaling mapalitan ang mga naka-install na bersyon ng Python. Pinapayagan nito ang paggamit ng iba’t ibang bersyon para sa bawat proyekto, at nakakaiwas sa mga isyu sa dependency sa bawat kapaligiran.

Pagpalit ng Bersyon para sa Buong Sistema Upang baguhin ang bersyon ng Python na gagamitin sa buong sistema, gamitin ang sumusunod na utos.

   pyenv global 3.9.1

Itatakda ng utos na ito na gamitin ang Python 3.9.1 sa buong sistema. Ang bersyon na ito ay magiging aktibo sa lahat ng direktoryo.

Pagpalit ng Bersyon Ayon sa Proyekto Kung nais mong baguhin ang bersyon ng Python lamang sa loob ng isang tiyak na direktoryo, gamitin ang utos na pyenv local. Kapaki-pakinabang ito kapag nais mong magtakda ng iba’t ibang bersyon para sa bawat proyekto.

   pyenv local 3.8.0

Kapag pinatakbo mo ang utos na ito, gagamitin lamang ang Python 3.8.0 sa kasalukuyang direktoryo, at sa ibang mga direktoryo ay ilalapat ang bersyon na itinakda sa pyenv global.

Pagsusuri ng Kasalukuyang Bersyon Upang tingnan kung aling bersyon ng Python ang ginagamit sa kasalukuyang sistema o proyekto, gamitin ang sumusunod na utos.

   pyenv version

Ipapakita ng utos na ito ang bersyon ng Python na nakatakda sa buong sistema o sa lokal na direktoryo.

Pag-uninstall ng Bersyon

Kung hindi na kailangan ang isang proyekto o kailangan mong tanggalin ang maling na-install na bersyon ng Python, madaling ma-uninstall ang bersyon gamit ang pyenv.

Paraan ng Uninstall Upang tanggalin ang na-install na bersyon ng Python, patakbuhin ang sumusunod na utos.

   pyenv uninstall 3.9.1

Sa pamamagitan ng utos na ito, matatanggal ang Python 3.9.1 mula sa system.

4. Pagsasama ng virtualenv

pyenv ay malakas na sumusuporta sa pamamahala ng bersyon ng Python, ngunit karaniwan na gamitin ito kasabay ng virtualenv (virtual na kapaligiran) upang mas epektibong pamahalaan ang mga dependency sa mga proyekto ng Python. Sa seksyong ito, ipapaliwanag kung paano pagsamahin ang pyenv at virtualenv, at ang mga benepisyo nito。

Ano ang virtualenv?

virtualenv ay isang tool na lumilikha ng hiwalay na virtual na kapaligiran para sa bawat proyekto ng Python, na nag-iisolasyon ng mga dependency ng library at package. Sa ganitong paraan, kahit na maraming proyekto sa parehong sistema ang gumagamit ng magkaibang bersyon ng mga package, maaari silang mag-develop nang hindi nagkakaroon ng salungatan。 Halimbawa, kung sa Proyekto A ay gumagamit ng bersyon 2.0 ng requests, at sato B ay bersyon 3.0, maaaring magtayo ng hiwalay na kapaligiran para sa bawat proyekto。

Pagkakaiba ng pyenv at virtualenv

pyenv ay pangunahing nakatuon sa pamamahala ng bersyon ng Python, isang tool para mag-install at magpalit ng iba’t ibang bersyon ng Python sa buong sistema o per proyekto. Samantala, ang virtualenv ay tool para pamahalaan ang dependency ng mga library at package ng Python sa loob ng virtual na kapaligiran。 Sa pamamagitan ng pagsasama ng pyenv at virtualenv, may mga sumusunod na benepisyo：

Pamamahala ng maraming bersyon ng Python: Gamit ang pyenv, mag-install ng iba’t ibang bersyon ng Python at itakda ang pinakaangkop na bersyon para sa bawat proyekto.
Pamamahala ng dependency ng mga library per proyekto: Gamit ang virtualenv, lumikha ng virtual na kapaligiran para sa bawat proyekto upang maiwasan ang salungatan ng mga library at package.

Pag-install ng pyenv-virtualenv

Sa pamamagitan ng pagdagdag sa pyenv ng plugin na tinatawag na pyenv-virtualenv, mas pinadadali ang paglikha at pamamahala ng virtual na kapaligiran. Maaaring i-install ito sa mga sumusunod na hakbang。

Mga hakbang sa pag-install pyenv-virtualenv ay maaaring i-install gamit ang sumusunod na utos。

   brew install pyenv-virtualenv

Para sa mga Linux user, maaaring i-install gamit ang sumusunod na utos。

   git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

Pagsasaayos ng environment variable Pagkatapos ng pag-install, idagdag ang sumusunod na linya sa iyong shell configuration file upang paganahin ang pyenv-virtualenv。

   echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bash_profile
   source ~/.bash_profile

Paglikha ng virtual na kapaligiran

Gamit ang pyenv-virtualenv, maaari kang lumikha ng virtual na kapaligiran para sa bawat bersyon ng Python. Halimbawa, upang lumikha ng virtual na kapaligiran gamit ang Python 3.8.0, patakbuhin ang sumusunod na utos。

pyenv virtualenv 3.8.0 my_project_env

Kapag pinatakbo mo ang utos na ito, isang virtual na kapaligiran na my_project_env</> na nakabatay sa Python 3.8.0 ang malilikha。

Pagpapalit ng virtual na kapaligiran

Upang magamit ang nilikhang virtual na kapaligiran sa isang proyekto, gamitin ang utos na pyenv local。

pyenv local my_project_env

Kapag pinatakbo mo ito, ang virtual na kapaligiran my_project_env ay magiging aktibo sa tinukoy na direktoryo. Sa ibang mga direktoryo, gagamitin ang globally na nakatakdang bersyon ng Python。

Pag-delete ng virtual na kapaligiran

Kung hindi na kailangan ang virtual na kapaligiran, maaari itong madaling tanggalin gamit ang utos na pyenv uninstall。

pyenv uninstall my_project_env

Kaginhawaan ng virtualenv

Sa pamamagitan ng pagsasama ng pyenv at virtualenv, maaaring ganap na paghiwalayin ang pamamahala ng bersyon ng Python at mga dependency ng library sa maraming proyekto. Dahil dito, nababawasan ang panganib ng salungatan ng mga package sa pagitan ng mga proyekto, at napapanatiling matatag ang kapaligiran ng pag-develop ng bawat proyekto。

5. Mga Dapat Tandaan Kapag Gumagamit ng pyenv

pyenv at virtualenv ay nagbibigay-daan sa napakaepektibong pamamahala ng bersyon ng Python at paghihiwalay ng mga kapaligiran, ngunit may mga dapat tandaan at mga bahagi kung saan madalas magkaproblema. Dito, tatalakayin nang detalyado ang mga karaniwang problema sa paggamit ng pyenv at ang mga solusyon.

1. Limitadong Suporta sa Windows

pyenv ay pangunahing inirerekomenda para sa macOS at Linux. Walang direktang suporta para sa Windows, kaya may mga limitasyon sa paggamit. Kung nais ng mga Windows user na gamitin ang pyenv, narito ang ilang mga opsyon.

Windows Subsystem for Linux (WSL) : Mag-install ng WSL upang magtayo ng Linux environment at gamitin ang pyenv doon. Sa ganitong paraan, maaaring gamitin ang pyenv sa Windows katulad ng sa Linux.
Anaconda : Sa halip na pyenv, maaaring gamitin ang Anaconda upang pamahalaan ang maraming bersyon ng Python at mga virtual environment kahit sa Windows.

2. Error Dahil sa Kakulangan ng Dependent Packages

Lalo na sa Linux, kapag nag-iinstall ng pyenv, maaaring mag-error kung kulang ang mga kinakailangang dependent libraries. Kapag nakita ang mensaheng tulad nito, kailangan i-install ang mga dependent libraries.

WARNING: The Python bz2 extension was not compiled. Missing the bzip2 lib?

Solusyon：

I-install ang kinakailangang dependent packages (hal., libbz2-dev at libssl-dev), at muling patakbuhin ang pyenv install. Gamitin ang sumusunod na command para i-install ang mga dependent libraries.

   sudo apt-get install -y build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev

3. Pagkakontra sa Umiiral na Python Version at pyenv

Maaaring magkontra ang Python na naka-install na sa system at ang bersyon ng Python na pinamamahalaan ng pyenv. Nangyayari ito kapag mali ang path settings o hindi tama ang shell initialization settings. Solusyon：

Suriin kung tama ang pagdaragdag ng mga pyenv na setting sa shell initialization file (hal., .bashrc o .zshrc). Lalo na siguraduhing tama ang PATH setting at kasama ang mga sumusunod na linya.

   export PATH="$HOME/.pyenv/bin:$PATH"
   eval "$(pyenv init --path)"

Pagkatapos ng setting, i-restart ang terminal o patakbuhin ang source ~/.bashrc para ma-apply ang mga pagbabago.

4. Nabigong Mag-Install ng Partikular na Python Version

Minsan nabibigo ang pag-install ng partikular na bersyon ng Python. Kadalasan ito dahil kulang ang kinakailangang build tools o libraries sa system. Solusyon：

I-install ang mga kulang na dependent libraries at subukang muli. Para sa Linux users, i-install ang build-essential, libssl-dev, atbp., at muling patakbuhin ang pyenv install.

5. Mali sa Pagtukoy ng Python Version

Kapag tinutukoy ang bersyon ng Python gamit ang pyenv, maaaring mag-error kung may maling pag-type ng bersyon. Lalo na kapag gumagamit ng pyenv install, siguraduhing ang bersyon na ilalagay ay makikita sa pyenv install --list. Solusyon：

Upang maiwasan ang maling pagtukoy ng bersyon, mahalagang suriin muna ang mga available na bersyon at ilagay ang tamang numero.

6. Pagkakontra ng Virtual Environments

Kapag gumagamit ng maraming virtual environments, maaaring magkontra ang mga dependency sa pagitan ng mga environment na gumagamit ng parehong bersyon ng Python. Sa ganitong kaso, maaaring magbanggaan ang mga bersyon ng package at magdulot ng hindi tamang pag-andar. Solusyon：

Lumikha ng hiwalay na virtual environment para sa bawat proyekto, at gamitin ang virtualenv o pyenv-virtualenv upang ganap na paghiwalayin ang mga dependency. Kahit na pareho ang bersyon ng Python, ang paglikha ng hiwalay na environment para sa bawat proyekto ay makakaiwas sa mga banggaan.

6. Buod at Susunod na Hakbang

pyenv ay isang napaka-kapaki-pakinabang at makapangyarihang tool para sa pamamahala ng bersyon ng Python. Lalo na para sa mga developer na kailangang gumamit ng iba’t ibang bersyon ng Python sa maraming proyekto, ang paggamit ng pyenv ay nagpapadali ng pagpapalit ng bersyon at nagpapahusay sa pamamahala ng kapaligiran ng pag-unlad. Bukod dito, kapag pinagsama sa virtualenv, nagiging mas madali ang pamamahala ng mga dependency per proyekto, at maaaring magamit ang maraming virtual na kapaligiran sa iisang sistema.

Buod ng Paggamit ng pyenv

Kaginhawaan sa Pamamahala ng Bersyon: Sa paggamit ng pyenv, madali mong mapapalitan ang maraming bersyon ng Python sa buong sistema o per proyekto.
Pagsasama ng Virtual na Kapaligiran: Sa pamamagitan ng paggamit ng pyenv-virtualenv at virtualenv, maaaring ihiwalay ang mga dependency ng mga Python na proyekto at pamahalaan nang mahusay ang maraming proyekto.
Kahalagahan ng Troubleshooting: Mahalaga ring maghanda para sa mga posibleng error at conflict na maaaring lumitaw kapag gumagamit ng pyenv, at tiyaking tama ang pag-set ng mga dependency at bersyon.

Susunod na Hakbang

Layunin ang Higit pang Pagiging Epektibo gamit ang pyenv: Kapag napag-aralan mo na ang mga pangunahing operasyon ng pyenv, susunod ay isaalang-alang ang pagsasama ng mga tool tulad ng pipenv at poetry upang higit pang mapabuti ang iyong kapaligiran sa pag-unlad. Ang mga tool na ito ay nagpapasimple ng pamamahala ng mga dependency at nag-aautomat ng pag-setup per proyekto.
Pag-angkop sa Ibang Kapaligiran ng Pag-unlad: Para sa mga Windows user, dahil hindi direktang sinusuportahan ang pyenv, maaaring isaalang-alang ang paggamit ng WSL (Windows Subsystem for Linux) o iba pang mga tool tulad ng Anaconda.
Subukan sa Tunay na Proyekto: Huwag lang intindihin ang teorya; subukan mong i-implement ang pyenv sa mga proyekto. Ilapat ang pyenv sa mga umiiral at bagong proyekto, lumikha ng mga virtual na kapaligiran, at maranasan kung gaano kadali ang pamamahala ng mga library.

オープンソースの力を活用する方法～Ubuntuの世界へようこそ～

Ubuntuにおけるpyenvのセットアップと活用法｜Python環境管理ガイド

目次 1 1. はじめに1.1 Pythonバージョン管理の重要性1.2 Ubuntuとpyenvの組み合わせの利点2 …