Vianetsintä: Terminalit

Korjaa yleisiä Terminal-ongelmia — tyhjä tuloste, kirjoitusongelmat, AI Agent -häiriöt.

Terminal avautuu mutta ei tulosta kirjoittaessa

Oireet: painat näppäimiä mutta mitään ei ilmesty Terminaliin, tai Terminal avautuu tyhjällä näytöllä ja pysyy sellaisena.

Mahdolliset syyt ja korjaukset:

Shell-alustustiedoston virhe. Shell-käynnistystiedostossasi (.zshrc, .bashrc tai .bash_profile) saattaa olla syntaksivirhe tai komento, joka jää jumiin. Avaa tavallinen Bash Terminal 1DevToolissa ja suorita:

bash
cat ~/.zshrc

Etsi ilmeisiä virheitä — puuttuva sulkeva lainausmerkki, määrittelemätön muuttuja tai source-komento, joka osoittaa tiedostoon, jota ei ole olemassa. Korjaa virhe Env Managerissa tai tekstieditorissa, sitten avaa Terminal uudelleen.

Väärä Terminal-tyyppi. Jos valitsit "Claude Code" Terminalin mutta claude-CLI:tä ei ole asennettu, Terminal avautuu mutta shell ei onnistu käynnistämään Agentia. Asenna Claude Code ensin (npm install -g @anthropic-ai/claude-code), tai vaihda Terminal-tyypiksi tavallinen Bash- tai Zsh-sessio.

Pikaresetointi. Napsauta hiiren oikealla painikkeella missä tahansa Terminal-välilehdellä ja valitse Käynnistä Terminal uudelleen. Tämä tappaa nykyisen shell-prosessin ja käynnistää uuden ilman paneelin sulkemista.


AI Agent ei vastaa syötteeseen

Oireet: kirjoitat kehotteen Agent-Terminaliin mutta mitään ei tapahdu — ei pyörijää, ei vastausta, ei kuittausta.

Yleisin syy on se, että Agentin käyttöliittymä on alitilassa, jossa se ei lue syötettäsi. Esimerkiksi jos Agent avasi tiedoston tekstieditorissa kuten vim tai nano Terminalin sisällä, näppäinpainallukset menevät kyseiseen editoriin Agentin sijaan.

Korjaukset:

  • Paina Ctrl+C kerran tai kahdesti peruuttaaksesi Agentin tekemän toiminnon ja palauttaaksesi sen pääkomentokehotteeseen. Kirjoita sitten viestisi uudelleen.
  • Käytä Agent Input Overlay -toimintoa sen sijaan, että kirjoitat suoraan Terminaliin. Paina Cmd+I (tai Ctrl+I Windows/Linuxilla) avataksesi erillinen syöttölaatikko, joka lähettää kehottesi siististi Agentille ohittaen Terminal-tilan ongelmat.
  • Jos Agent vaikuttaa täysin jäätyneen, napsauta hiiren oikealla painikkeella Terminal-välilehteä ja valitse Käynnistä Terminal uudelleen aloittaaksesi uuden Agent Session.

Vierityspuskuri katkeaa Agent-vastauksen jälkeen

Oireet: Agentin tuotettua pitkän vastauksen, vierität ylös mutta pääset vain tiettyyn pisteeseen. Aiempi tuloste on kadonnut.

Korjaukset:

  • Napsauta Terminal-otsikossa olevaa Laajenna vierityspuskuria -painiketta (nuoli-kuvake Terminal-paneelin oikeassa yläkulmassa). Tämä lataa tilapäisesti enemmän historiaa näkymään.
  • Pysyvän korjauksen saamiseksi suurenna vierityspuskurin rajaa: mene kohtaan Asetukset → Terminal → Vierityspuskuririvit. Oletusarvo on 10 000 riviä. Voit nostaa sen jopa 100 000:een. Huomaa, että erittäin suuret vierityspuskurit kuluttavat enemmän muistia.

Terminal näyttää "[detached]"-viestin

Saatat nähdä rivin kuten [detached (from session main)] Terminal-paneelin yläosassa. Tämä on viesti tmuxilta, Terminal-multiplekserin, jota 1DevTool käyttää pitämään sessiot elossa taustalla.

Se tarkoittaa, että näyttö oli väliaikaisesti irrotettu käynnissä olevasta sessiosta ja sitten yhdistetty uudelleen. Tämä on täysin normaalia — se tapahtuu tyypillisesti kun vaihdat projekteja, piilotat ja avaat Terminalin uudelleen tai sovellus palautetaan minimoidusta tilasta. Sessiosi ja kaikki käynnissä olevat prosessit ovat koskemattomat.


Piilotettu Terminal käynnistää uuden Session jatkamisen sijaan

Oireet: piilotat Terminalin napsauttamalla pois tai sulkemalla paneelin, avaat sen sitten uudelleen, ja Terminal käynnistyy alusta — aiemmat komennot ja käynnissä olevat prosessit ovat poissa.

Syy: 1DevTool käyttää tmuxia pitämään Terminal-sessiot elossa taustalla. Jos tmuxia ei ole asennettu tai se ei ole shellisi PATH-muuttujassa, sessiota ei voida säilyttää ja se käynnistyy alusta joka kerta.

Korjaus: asenna tmux ja käynnistä 1DevTool uudelleen.

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo dnf install tmux

Asennuksen jälkeen sulje 1DevTool kokonaan ja käynnistä se uudelleen. Uudet Terminal-sessiot säilyvät nyt piilotettaessa.


Korkea suorittimen käyttö Terminaleista

Jos koneesi on kuuma tai tuulettimet pyörivät kovaa, Terminal-prosessi saattaa kuluttaa liikaa suoritinta.

Lähteen tunnistamiseksi: vie hiiri jokaisen Terminal-välilehden päälle. Aktiivinen välilehti näyttää pyörivän indikaattorin. Voit myös avata Terminalin ja suorittaa top tai htop nähdäksesi mikä prosessi on vastuussa.

Pysäyttääksesi sen:

  • Paina Ctrl+C Terminalissa keskeyttääksesi käynnissä olevan prosessin.
  • Tai napsauta hiiren oikealla painikkeella Terminal-välilehteä ja valitse Tapa prosessi pakottaaksesi lopetuksen sille, mikä sen sisällä käy.

Jos prosessi on villikäyttäytyvä kehityspalvelin tai rakennustyökalu, se on turvallista tappaa ja käynnistää uudelleen normaalilla käynnistyskomennollasi.