환경 문제

시스템 환경, 셸 및 의존성과 관련된 일반적인 문제를 해결합니다.

​

PowerShell이 인식되지 않음

문제: “PowerShell이 내부 또는 외부 명령으로 인식되지 않습니다”라는 오류 메시지가 표시됩니다. 해결책:

• Windows 사용자:
  • PowerShell을 시스템 PATH에 추가
  • 설정 → 시스템 → 정보 → 고급 시스템 설정 → 환경 변수 열기
  • PowerShell 경로 추가: C:\Windows\System32\WindowsPowerShell\v1.0\
  • PATH 변경 후 SoloEnt 재시작
• 대안:
  • 대신 명령 프롬프트 (cmd) 사용
  • 설정에서 기본 터미널 변경
  • PowerShell이 없으면 재설치

​

명령을 찾을 수 없음

문제: 터미널에 “명령을 찾을 수 없음” 또는 유사한 오류가 표시됩니다. 해결책:

• 명령/도구가 시스템에 설치되어 있는지 확인
• 명령이 시스템 PATH에 있는지 확인
• 새 도구 설치 후 터미널 재시작
• 필요한 경우 실행 파일의 전체 경로 사용
• 누락된 의존성 설치

​

Python/Node를 찾을 수 없음

문제: Python 또는 Node.js 명령이 작동하지 않습니다. 해결책:

• python.org에서 Python 또는 nodejs.org에서 Node.js 설치
• 설치 확인: python --version 또는 node --version
• 설치되었지만 인식되지 않으면 PATH에 추가
• 설치 후 SoloEnt 재시작
• 버전 충돌 확인 (여러 Python/Node 버전)

​

권한 거부 오류

문제: “권한 거부됨” 또는 “액세스 거부됨” 오류가 표시됩니다. 해결책:

• macOS/Linux:
  • 적절한 경우 sudo 사용
  • ls -la로 파일 권한 확인
  • 시스템 설정에서 전체 디스크 접근 권한 부여
• Windows:
  • 필요한 경우 관리자로 SoloEnt 실행
  • 폴더 보안 설정 확인
  • 사용자 계정 컨트롤 일시적으로 비활성화

​

공백이 있는 경로로 오류 발생

문제: 파일 경로에 공백이 포함되면 명령이 실패합니다. 해결책:

• 경로를 따옴표로 감싸기: "C:\My Documents\project"
• 터미널에서 이스케이프 문자 사용
• 프로젝트 폴더 이름에 공백 사용 피하기
• 대신 하이픈 또는 밑줄 사용: my-project (my project 아님)

​

Git을 사용할 수 없음

문제: Git 명령이 작동하지 않거나 Git을 찾을 수 없습니다. 해결책:

• git-scm.com에서 Git 설치
• 설치 확인: git --version
• Git을 시스템 PATH에 추가
• 설치 후 터미널/SoloEnt 재시작
• 대안으로 GitHub Desktop 사용

​

환경 변수가 설정되지 않음

문제: 애플리케이션이 필요한 환경 변수를 찾을 수 없습니다. 해결책:

• 시스템 설정에서 변수 설정 (터미널 세션만이 아님)
• Windows: 시스템 속성 → 환경 변수
• macOS/Linux: ~/.zshrc 또는 ~/.bashrc에 추가
• 변수 설정 후 SoloEnt 재시작
• echo $VARIABLE_NAME (Unix) 또는 echo %VARIABLE_NAME% (Windows)로 확인

​

셸 호환성 문제

문제: 명령이 한 셸에서는 작동하지만 다른 셸에서는 작동하지 않습니다. 해결책:

• 사용 중인 셸 확인: echo $SHELL
• 호환되는 셸로 전환 (bash, zsh, PowerShell)
• SoloEnt 설정에서 기본 셸 구성
• 가능한 경우 크로스 플랫폼 명령 사용

​

시스템 아키텍처 불일치

문제: 도구 또는 바이너리가 시스템과 호환되지 않습니다. 해결책:

• 시스템 아키텍처 확인: uname -m (Unix) 또는 systeminfo (Windows)
• 올바른 버전 다운로드 (x64, ARM64 등)
• 호환 가능한 대안 사용
• 필요한 경우 Apple Silicon Mac에서 Rosetta 2 활성화

​

백신이 작업 차단

문제: 백신 소프트웨어가 SoloEnt 작업에 간섭합니다. 해결책:

• SoloEnt를 백신 화이트리스트/예외에 추가
• 테스트를 위해 일시적으로 백신 비활성화
• 차단된 작업에 대한 백신 로그 확인
• 적절한 구성을 위해 백신 지원팀에 문의

​

디스크 공간 문제

문제: 디스크 공간 부족으로 작업이 실패합니다. 해결책:

• 사용 가능한 디스크 공간 확인
• 임시 파일 및 캐시 정리
• 더 많은 공간이 있는 드라이브로 프로젝트 이동
• 불필요한 파일 삭제

​

네트워크/방화벽 문제

문제: API 서비스에 연결할 수 없거나 업데이트를 다운로드할 수 없습니다. 해결책:

• 방화벽 설정 확인
• 방화벽에서 SoloEnt 허용
• 기업 방화벽 뒤에 있는 경우 프록시 설정 구성
• 다른 네트워크로 연결 테스트
• 기업 환경에서는 IT 부서에 문의

​

여전히 문제가 있나요?

​

환경 문제 보고

환경 문제를 보고할 때 다음을 포함하세요:

• 운영 체제: Windows 10/11, macOS 버전, Linux 배포판
• 시스템 아키텍처: x64, ARM64, Apple Silicon
• 셸 유형: PowerShell, CMD, bash, zsh
• 오류 메시지: 모든 오류의 전체 텍스트
• 시도한 단계: 보고 전에 시도한 것

이 정보는 문제를 더 빠르게 진단하고 해결하는 데 도움이 됩니다.