Excelize v2.9.1

• 이에 출시: 2025 년 5 월 13 일
• GitHub 릴리스: https://github.com/xuri/excelize/releases/tag/v2.9.1

릴리스 노트

이 릴리스에서 가장 주목할 만한 변경 사항은 다음과 같습니다:

호환성

• golang.org/x/crypto 의존성 패키지의 업그레이드를 위해, Go 언어 버전 요구 사항이 1.23 이상으로 변경되었습니다
• DataValidationType, DataValidationErrorStyle, DataValidationOperator, PictureInsertType 의 데이터 타입이 int 에서 byte 로 변경되었습니다
• SetCellInt 함수는 이제 int64 타입의 매개변수를 요구합니다, 관련 문제 #2068
• 그림, 차트, 도형, 양식 컨트롤 등의 그리기 개체를 추가할 때 오프셋 설정이 더 이상 그리기 개체의 크기에 영향을 미치지 않습니다, 관련 문제 #2001

주목할 만한 기능

• Chart 데이터 타입에 새로운 필드 GapWidth 와 Overlap 이 추가되었습니다
• ChartPlotArea 데이터 유형에 새로운 필드 ShowDataTable 및 ShowDataTableKeys 가 추가되었습니다
• ChartAxis 데이터 타입에 새로운 필드 Alignment 가 추가되었습니다
• ChartSeries 데이터 타입에 새로운 필드 DataLabel 이 추가되었습니다
• PageLayoutOptions 데이터 타입에 새로운 필드 PageOrder 가 추가되었습니다
• 2 개의 새로운 익스포트 오류 변수인 ErrPageSetupAdjustTo 와 ErrStreamSetColStyle 이 추가되었습니다
• 2 개의 새로운 익스포트 열거형인 HeaderFooterImagePositionType 와 IgnoredErrorsType 이 추가되었습니다
• 2 개의 새로운 익스포트 데이터 타입인 CalcPropsOptions 와 HeaderFooterImageOptions 가 추가되었습니다
• 워크북 계산 속성을 설정하고 가져올 수 있도록 2개의 새로운 함수 SetCalcProps 와 GetCalcProps 가 추가되었습니다
• 일본 달력 연도, 한국의 단기 달력, 중화민국 연도에 대한 숫자 형식을 지원하기 위해 새로운 열거값 CultureNameJaJP, CultureNameKoKR 및 CultureNameZhTW 가 추가되었습니다, 관련 문제 #1885
• 헤더와 풋터에 그래픽을 설정할 수 있도록 새로운 함수 AddHeaderFooterImage 가 추가되었습니다, 관련 문제 #1395
• 셀 범위에 대한 오류 무시 기능을 지원하기 위해 새로운 함수 AddIgnoredErrors 가 추가되었습니다, 관련 문제 #2046
• 스트리밍 라이터에서 열 스타일 설정을 지원하기 위해 새로운 함수 SetColStyle 이 추가되었습니다, 관련 문제 #2075
• AddChart 및 AddChartSheet 함수는 차트 축의 텍스트 방향 및 회전을 설정할 수 있도록 지원합니다, 관련 문제 #2025
• AddChart 및 AddChartSheet 함수는 열 및 막대 차트의 간격 폭과 중첩 값을 설정할 수 있도록 지원합니다, 관련 문제 #2033
• AddChart 및 AddChartSheet 함수는 차트 시리즈 데이터 레이블의 형식을 설정할 수 있도록 지원합니다, 관련 문제 #2052
• AddChart 및 AddChartSheet 함수는 차트에 대한 데이터 테이블 설정을 지원합니다, 관련 문제 #2117
• AddFormControl 함수는 체크박스에 대한 셀 링크 설정을 지원합니다, 관련 문제 #2113
• SetPageLayout 함수는 페이지 레이아웃의 페이지 순서를 설정할 수 있도록 지원합니다
• DeletePicture 함수는 특정 셀에 고정된 이미지를 삭제할 수 있도록 지원합니다, 관련 문제 #2059
• SetPageLayout 함수의 옵션 값이 유효하지 않은 경우 오류가 반환됩니다
• 여러 워크시트에 걸친 데이터 유효성 검사를 조정하는 기능을 지원합니다, 관련 문제 #2072
• 해시 기호와 0 자리 표시자를 포함한 숫자 형식 적용을 지원합니다, 관련 문제 #2058
• ? 기호를 포함한 숫자 형식 적용을 지원합니다
• "oneCell" 로 위치를 지정하면 셀 앵커 도면 개체 하나를 삽입할 수 있습니다, 관련 문제 #2002

버그 수정

• v2.9.0 에서 발생한 회귀 버그를 수정하였습니다. 스트리밍 라이터가 생성한 워크북을 열 때 워크북이 손상되는 문제를 해결하였습니다, 관련 문제 #2015
• 불필요한 none 유형 패턴 채움이 생성되는 문제를 수정하였습니다, 관련 문제 #2014
• 일부 경우에서 수직 및 수평 테두리 스타일이 누락되는 문제를 수정하였습니다, 관련 문제 #2048
• 일부 경우에서 조건부 서식의 테두리 스타일이 누락되는 문제를 수정하였습니다, 관련 문제 #2061
• 일부 경우 피벗 테이블을 가져올 때 발생하는 패닉 현상을 수정하였습니다, 관련 문제 #1954 및 #2051
• GetStyle 함수가 VertAlign 서식을 가져오지 못하는 문제를 수정하였습니다
• 일부 경우에서 CalcCellValue 함수의 부분 표현식이 올바르게 계산되지 않는 문제를 수정하였습니다, 관련 문제 #2083
• 이미지 참조 감지 문제로 인해 잘못된 이미지가 삭제되는 문제를 수정하였습니다
• 스트리밍 라이터를 사용하여 행을 설정할 때, 기본 셀 스타일이 0 이 아닌 행 스타일에 의해 덮어쓰여지지 않는 문제를 수정하였습니다
• 스트리밍 라이터에서 불필요한 cols 요소가 생성되는 문제를 수정하였습니다
• 차트 제목 글꼴 설정 시 패닉 현상 수정, 관련 문제 #2102
• 어떤 경우에는 Calc 체인 삭제 시 패닉 현상이 발생합니다
• 공유 수식 구문 분석 오류로 인해 잘못된 수식 계산 결과가 발생하는 문제를 해결합니다, 관련 문제 #2056
• 내부 ZIP64 파일 크기가 4GB를 초과할 때 생성된 손상된 통합 문서를 수정합니다
• 시트 이름을 바꾼 후 정의된 이름에서 시트 이름 오류를 수정합니다, 관련 문제 #2126

성능 최적화

• github.com/mohae/deepcopy 대신 3배 빠른 deepcopy 라이브러리인 github.com/tiendc/go-deepcopy 를 사용합니다, 관련 문제 #2029
• v2.9.0 에서 성능 회귀를 수정하고 빈 셀에 대한 트림 셀 값 메모리 할당을 줄였습니다
• 수식에 전체 열과 행 참조가 포함된 경우 계산 수식의 성능을 향상시킵니다
• 행 반복자 속도가 약 20% 향상되고 메모리 할당이 약 10% 감소합니다

기타

• Go Modules 는 모듈 업데이트에 의존합니다
• 단위 테스트 및 godoc 업데이트
• 다국어를 지원하는 문서 웹사이트: 아랍어, 독일어, 영어, 스페인어, 프랑스어, 이탈리아어, 일본어, 한국어, 포르투갈어, 러시아어, 중국어 간체 및 중국어 번체, 업데이트됨
• excelize-wasm WebAssembly / JavaScript 지원을 위한 NPM 패키지 릴리스 업데이트
• excelize Python을 위한 PyPI 패키지 릴리스 업데이트

고맙습니다

Excelize 에 기여한 모든 분들께 감사드립니다. 아래는 이 버전에서 코드 기여도가 있는 기여자 목록입니다:

• @wushiling50
• @imirkin (Ilia Mirkin)
• @Juneezee (Eng Zer Jun)
• @Arpelicy
• @zhuhaicity (ZhuHaiCheng)
• @xxf0512 (xxf)
• @gypsy1234
• @mengpromax (MengZhongYuan)
• @hly-717
• @kurtinge (Kurt Inge Smådal)
• @IvanHristov98 (Ivan Hristov)
• @artur-chopikian (Artur Chopikian)
• @romanshevelev (Roman Shevelev)
• @LZCZ
• @hm3248
• @moisespsena (Moises P. Sena)
• @paolobarbolini (Paolo Barbolini)
• @timesince
• @shcabin
• @tgulacsi (Tamás Gulácsi)
• @R3dByt3 (R3dByt3)
• @Now-Shimmer