troubleshooting

Espanso가 동작하지 않을 때 | 흔한 해결 방법 8가지 (2026)

Trofin Sorin-IoanTrofin Sorin-IoanCTO, Lightning Assist2026년 3월 29일8 분 읽기
espansotext-expandertroubleshootinglinuxwindowsmacos
공유:
Lightning Assist 블로그 게시물 추천 이미지

Espanso 작동하지 않나요? 8가지 일반적인 수정 사항(2026년)

Espanso은 강력한 오픈 소스 텍스트 확장기이지만 YAML 기반 구성으로 인해 명확하지 않은 방식으로 문제가 발생할 수 있습니다. Espanso 작동이 중지되는 가장 일반적인 이유와 각 문제를 해결하는 방법은 다음과 같습니다. 공식 CLI 및 경로는 Espanso 문서를 참조하세요.

1. Espanso이(가) 실행되고 있지 않습니다.

가장 일반적인 원인: Espanso 서비스가 시작되지 않았습니다.

수정:

espanso start

실행 중인지 확인하세요.

espanso status

systemd를 사용하는 Linux에서:

systemctl --user status espanso
systemctl --user start espanso

2. YAML 구성의 구문 오류

구성 파일에 잘못된 YAML이 있으면 Espanso이 자동으로 실패합니다. 잘못 배치된 탭이나 콜론 하���가 전체 파일을 손상시킵니다.

수정: 구성 의사를 실행합니다.

espanso doctor

확인해야 할 일반적인 실수:

  • 공백 대신 탭 사용(YAML에는 공백이 필요함)
  • :, # 또는 \와 같은 특수 문자가 포함된 텍스트 주위에 따옴표가 누락되었습니다.
  • 한칸씩 벗어난 들여쓰기
  • {로 시작하는 replace: 값 — 따옴표로 묶어야 합니다: replace: "{{clipb}}"

3. Espanso 특정 애플리케이션에서 작동하지 않음

일부 애플리케이션, 특히 Electron 앱(VS Code, Slack, Discord), 터미널 및 사용자 정의 입력 처리 기능이 있는 앱은 Espanso의 시뮬레이션된 키 입력을 올바르게 수신하지 못합니다.

Linux 수정: 올바른 주입 백엔드를 사용하고 있는지 확인하세요. ~/.config/espanso/config/default.yml 수정:

backend: Auto

Auto, Clipboard 및 Inject 간에 전환해 보세요.

backend: Clipboard

Windows 수정: 관리자 권한으로 Espanso을 실행하세요. 특히 높은 권한으로 실행되는 앱의 경우 더욱 그렇습니다.

macOS 수정: 시스템 설정 → 개인 정보 보호 및 보안 → 접근성으로 이동하여 목록에서 Espanso을(를) 제거한 다음 다시 추가하세요.

4. 접근성 권한 누락(macOS)

접근성 권한이 없으면 Espanso에서 키 입력을 모니터링하거나 텍스트 출력을 시뮬레이션할 수 없습니다.

수정:

  1. 시스템 설정 → 개인 정보 보호 및 보안 → 접근성을 엽니다.
  2. 목록에서 Espanso을(를) 찾으세요.
  3. 전원을 껐다가 다시 켜세요.
  4. Espanso 다시 시작: espanso restart

5. 트리거가 실행되지 않음 - 잘못된 트리거 유형

기본적으로 Espanso은 단어 구분 기호(공백, 줄 바꿈, 구두점) 뒤에서만 확장되는 단어 트리거를 사용합니다. 단어 중간에 트리거를 입력하면 확장되지 않습니다.

수정: 일치 파일에서 트리거 유형을 확인하세요. 어디서나 트리거하려면 word: false을 사용하세요.

matches:
  - trigger: ":sig"
    replace: "Best regards,\nYour Name"
    word: false

또는 더 많은 제어를 위해 regex 트리거 유��을 사용하세요.

matches:
  - regex: ":sig$"
    replace: "Best regards,\nYour Name"

6. Espanso 시스템 업데이트 후 작동하지 않음

OS 업데이트(특히 macOS 및 Linux)는 접근성 권한을 취소하거나 시스템 서비스를 중단시키는 경우가 많습니다.

수정:

  1. 접근성 권한을 다시 부여합니다(macOS에 대한 수정 4 참조).
  2. Linux에서 systemd 서비스를 다시 등록합니다: espanso service register
  3. Windows에서 Espanso이(가) 아직 시작 목록에 있는지 확인하세요.

7. 잘못된 위치에 있는 구성 파일

Espanso은 특정 위치에서 구성 파일을 찾습니다. .yml 일치 파일을 잘못된 폴더에 넣으면 해당 파일이 로드되지 않습니다.

기본 구성 위치:

  • Linux: ~/.config/espanso/
  • macOS: ~/Library/Application Support/espanso/
  • Windows: %APPDATA%\espanso\

일치 파일은 match/ 하위 디렉터리에 있어야 합니다. 시스템의 정확한 경로를 보려면 espanso path을 실행하세요.

8. Espanso 다른 애플리케이션과의 충돌

일부 애플리케이션이나 접근성 도구는 Espanso 자체 키 모니터링과 충돌하는 전역 단축키를 등록합니다.

수정:

  • 다른 접근성 도구, 화면 판독기 또는 단축키 관리자를 일시적으로 비활성화합니다.
  • Espanso 로그에서 오류를 확인하세요. espanso log
  • 전��� 진단을 위해 espanso doctor을 실행해 보세요.

아직도 작동하지 않나요? 로그 확인

espanso log

이는 Espanso이(가) 실패하는 이유를 정확하게 보여줍니다. 권한 오류, 구문 분석 오류 또는 백엔드 문제를 찾아보세요.

Espanso 구성이 유지 관리 부담이 되는 경우

Espanso의 YAML 구성은 강력한 기능을 제공하지만 실질적인 마찰을 추가합니다. 특히 시작하거나, 자동 오류를 디버깅하거나, 구성 파일에 익숙하지 않은 팀과 공동작업할 때 더욱 그렇습니다.

Espanso을 실제로 사용하는 것보다 문제를 해결하는 데 더 많은 시간을 소비하고 있다면 Lightning Assist — 전체 GUI, 내장 AI 명령, PTT(Push-to-Talk) 음성 입력 및 팀 스니펫 공유를 갖춘 그래픽 Windows, Mac 및 Linux용 텍스트 확장기을(를) 고려해 보십시오. 구성 파일이 없습니다. 14일 무료 평가판을 다운로드하세요 - 신용카드가 필요하지 않습니다.

자세한 비교는 Lightning Assist 및 Espanso을 참조하세요.

관련 글